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SECTION I 


GENERAL DESCRIPTION 


AN AID TO 
OPERATORS 


AN AID TO 
PROGRAMMERS 


AN AID TO 
OPERATIONS 


32KSYS; an operating system for Philco 2000 computers 
with 32, 768 words of core storage, .s an assembly of 
execut ve routvnes designed to provide efficient use of 
computer run time by standardizing operat ng procedures 
and by reducing the necessity for operator mtervent.or, 

32KSYS relieves the operator from manually performing 
such functions as program loading, rewinding tapes and 
enacting post moirem dumps It also minimizes the 
amount of tape mounting and d smounting between JOBS 
by providing a symbol'c tape assignment fac iity 

32KSYS provides many specialized routines to aid the 
programmer in running and debugging programs. More 
over, 32KSYS Entries, or internal subroutines, may be 
used to reduce such programmer tasks as repeat,ng 
numerous instructions to the operator, or calling external 
subroutines, 

Additional time saving for computer centers is gained as 
32KSYS can accept in succession any type of source 
language program ( ue. , TAG or ALTAC) to be compiled 
and run. 32KSYS also provides memory dumps or snap 
shots in the event of program failure. 

32KSYS reduces tape handling time by permitting input 
programs to be stacked (placed “n consecutive order) 
on the same tape prior to compilation or running. Simdar 
ly, object programs (those which have been compiled) and 
edited outputs can be stacked on their respective outpui 
tapes. 



GENERAL 32KSYS OPERATIONS 


32KSYS TAPE 
ASSIGNMENT 


COMMUNICATION 
WITH 32KSYS 


Control Lines 


32KSYS is on magnetic tape during the compilation or 
running of a program.. Most of its operations are also 
contained within memory at all times to direct the oper¬ 
ation of programs. As other sections of 32KSYS (not 
memory contained, because of infrequent use) are re¬ 
quired. they are read as three-block-length routines into 
memory from tape and executed. 32KSYS requires 4096 
words of memory (locations zero through 7777g ), leaving 
the remainder of the 32, 768 words of memory to the 
programmer's use, 

32KSYS contains a symbolic tape-assignment facility 
(see Section L), Tapes may be mounted on any available 
transport However in order that 32KSYS operate at 
maximum efficiency, the system tape must be assigned 
unit 1 and the ’n^ermedlate dump tape must be assigned 
unit 2, 

Communication between 32KSYS and the programmer may 
be made by Control Lines, 32KSYS Entries, 32KSYS 
Service Routines. Compilers, and TAC Library Routines 
for 32KSYS, 

Control Lines are written by the programmer in standard 
TAC instruction format and are submitted from outside a 
user's program, Each control line consists of a control 
instruction and its parameters, and causes actions such 
as. 


reading wr'ting, or rewinding tapes 

loading programs Into memory and transferring 
control to them 

stopping computer action or transferring control 
to a location in memory 

signifying the types of debugging memory dumps 
desired. 
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32KSYS Entries 


Service 

Routines 


Library 

Routines 


32KSYS Entries permit the programmer to call various 
routines stored within the brisic operations of 32KSYS. 
The programmer may call nese routines by writing a 
transfer of control from his program to a desired entry. 
Each entry is a location within 32KSYS which transfers 
control to its respective routine. The actual locations 
of these entries within 32KSYS are defined by preset 
symbol definitions in TAG. 

The entries include provisions for such operations as; 

• post-mortem dumps 

• Console Typewriter type-outs 

• reading, writing, and rewinding tapes 

e scanning routines for the Address and Remarks 
field of a TAC-format card, 

32KSYS Service Routines are generally called by writing 
a control line that designates the service routine as one 
of its parameters. These routines are specialized 
programs designed to aid the programmer in performing 
routine functions of tape maintenance, debugging, and 
program monitoring. 

Library Routines include special subroutines and gener¬ 
ators applicable to programs run under 32KSYS control. 
These are called by the programmer in the same manner 
as any TAG subroutine or generator. 


32KSYS CONVENTIONS 


The following conventions, definitions, and special 32KSYS 
symbols are used throughout the manual. 

MEMORY The beginning of memory is referred to as Location Zero. 

CONCEPT while the high-order locations are referred to as the end 

of memory. 

SENTINEL WORD 8 or fewer alphanumeric characters, excluding break 

characters. Spaces are ignored. If fewer than eight 
characters are used, the sentinel word will be right 
justified and left-filled with zeros. 
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SENTINEL BLOCK 


OPTIONAL 

PARAMETER 

BREAK 

CHARACTER 


ILLEGAL 

CHARACTER 


PROGRAM 

T-nTTMT'TTV I ID) 

J. 1. '« O. 4. ^ \ X Ju> f 


CODE MODE 


HOLLERITH-CODE 
MODE 

IMAGE MODE 


HOLLERITH-IMAGE 
MODE 


A block of 128 identical words. Only the first 120 words 
of the block are inspected by 32KSYS, however, during a 
sentinel search. Break characters are never included in 
the configuration of a sentinel block produced by the sys¬ 
tem. 

Optional parameters must be indicated by the presence 
of a break character, unless otherwise noted 


One of lour designated characters .s used to separate 
parameters within 32KSYS control lines it may be a 
comma ( , ), period (. ), semicolon ( ), or slash (/). No 
distinction is made between these break characters 
except where otherwise noted m this manual. 

0 

The special Phiico character e (Hollerith code 7) is an 
illegal character when entered via a 32KSYS control line 
paramete r 


Sixteen or fewer alphanumeric charac ters used 


tigu: 




a r* 


a CLii I 


as a 
s arc 
oad ing 


F unctions 


The format resulting from the card-to-tape conversion 
of cards punched in Hollerith code mto Phllco 2000 Code 
by the Punched Card Controller if Code Mode is indi¬ 
cated, 32KSYS assumes that data has been converted to 
Code Mode 10 words per card. 12 cards per block. 
(Refer to Phiico Codes, Appendix B. ) 


The same as Code Mode 


The format resulting from the card-to-tape process that 
transcribes the twelve rows of each column of a card as 
12 binary digits onto tape Punches are transcribed as 
ones. If Image Mode is indicated, 32 KSYS assumes that 
data has been transcribed in Image Mode, 20 words per 
card. Six cards per block. Image Mode format may be 
in either Hollerith-lmage Mode or Binary-Image Mode. 

The format resulting from Image Mode processing of 
cards punched in Hollerith code 
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BINARY- 
IMAGE MODE 

ADDRESS 


DUMP 

POST-MORTEM 

DUMP 

SNAPSHOT DUMP 

SYMBOLIC TAPE 


The format resulting from image Mode processing of 
cards punched in binary form Binary cards may be 
read only in Image Mode. 

The symbols used in the description of control instruc¬ 
tion parameters that call for an address, are indicative 
of the form in which they are to be supplied. Three 
symbols are used: 

m an octal number from 10000 to 11111 . 

loc an octal number from 10000 to 11111 ■ or an octal 

number from 0 to 67777 suffixed by a P, indicating 
the loLat.on s relative *^o a program origin, or an 
octal number from 0 to 67777 suffixed by a C 
ind'cating the location is relative to common. 

addr an octal number from 10000 to 77777. or an octal 

number from 0 to 67777 suffixed by a P, indicating 
the location is telaiive to a program origin, or an 
octal number from 0 to 67777 suffixed by a C . 
indicating the location is relative to common, or 
a symbol in the form NAME.FLAD 

addr may be augmented by s:n or ±nH, where n ;s 
a decimal number 

A dump is edited information from designated memory 
locations which is subsequently transmitted onto magnetic 
tape for off-line punting on the High-Speed Printer . 

A post-mortem dump .s a dump which occurs when con¬ 
trol is transferred to the iZKSYS entry 1 ZERO, 
lERRDMP, or ISUBERR, The dump is specified by the 
DUMP control instruction, 

A snapshot dump is a dump which occurs at designated 
locations durmg the running of an object program, as 
specified by the SNAP control instruction 

The tape which is defined by a symbolic tape name (refer 
to Symbolic Tapes) or a system program unit number, 
or a program unit number which has been previously definec 
by a TAPES instruction 
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PRESET SYMBOLS 
IN TAG 


The following is a list of preset TAG symbols: 


SYS. 1 ZERO 
SYS. ISYSIN 
SYS. lERRDMP 
SYS. lENDJOB 
SYS. INXTGON 
SYS. ITYPOUT 
SYS. 1 ENCODE 
SYS. ICLOCK 
SYS. IMEMSIZ 
SYS. ISCANBL 
SYS. IGETBL 
SYS. lIGBL 
SYS. ISCAN 
SYS. ISCANON 
SYS. ISTRIPQ 
SYS. IXCONER 
SYS. INXTCRD 
SYS. lINTLD 
SYS. ISYSRET 
SYS. lADCONI 
SYS. lADCONC 
SYS. lINTCMD 
SYS. ITAPENO 
SYS. IXECUTI 
SYS. IINTCON 
SYS. IPUNSYM 
SYS. IPRTCON 
SYS. IPRTMSG 
SYS. ISYSHLT 


SYS. IPRTRUN 
SYS. IXORD 
SYS.ISPORD 
SYS. ISETXRD 
SYS. ICHKORD 
SYS. IMXORD 
SYS. ICOMPER 
SYS. IXtAPE 
SYS. INTRYJA 
SYS. ISTART 
SYS. ICONBIT 
SYS. ICHARCT 
SYS. IIBIT 
SYS. ISYSOPS 
SYS. ICONLIN 
SYS. IDATE 
SYS. IBRKSTR 
SYS. IWRDl 
SYS. 1WRD2 
SYS. ICLORD 
XORD.XORD 
SPORD.SPORD 
SETXORD. SETXORD 
CHKORD.CHKORD 
MXORD.MXORD 
XTAPE.XTAPE 
CLORD.CLORD 
SYS. IMSGCON 
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SECTION II 


SYMBOLIC TAPES 


INTRODUCTION 


SYMBOLIC TAPE 
NAMES 


Tape assignment is that procedure whereby a particular 
reel of tape is connected in some manner with a particu¬ 
lar tape unit in preparation for input-output processing 
of the reel. In general, there are two methods of as¬ 
signing tapes for a job. 


The first method requires the programmer to pre-deter 
mine the connection of reels and units and to specify this 
connection to the operator. This method has proven to 
be prohibitive because often two independent successive 
jobs require different file tapes on the same logical tape 
unit. To prevent the delay associated with rewinding and 
dismounting the previous file tape and then mounting the 
required file tape, operators usually mount the second 
file tape on a different (unused) unit and when the file 
tape is needed, replug the logical/physical connection. 


The second method enables the operator to mount the 
file tape on any unit and to communicate the assignment 
to the program. This is the technique implemented in 
32KSYS. It requires little, if any, replugging of logical/ 
physical connections to provide tape assignment. It does 
require the use of symbolic tape names. 


A symbolic tape name is a collection of seven or fewer 
characters, one of which must be non-numeric, which 
uniquely identifies a tape reel for a particular job. 
Several special character sets are excluded from use 
within an object program. 

These are the System symbolic tape names; 


TSYSTEM 

TSYSDMP 

TSYSOUT 

TSYSLIB 

TSYSIN 


TSYSCRO 

TSYSCR3 

TSYSCR4 

TSYSCR6 
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OPERATOR 

ACTION 


USE OF 
SYMBOLIC 
TAPE NAMES 


EXTERNAL 
ASSIGNME NT 


At some point during the running of each job the operator 
must communicate to 32KSYS the logical unit number of 
each significant reel of tape. (A detailed description of 
operator action is given in Operating Procedures, Appen¬ 
dix A.) 

Symbolic tape names should be used whenever a tape 
parameter is specified, either in a system control in¬ 
struction, or in an object program Since the 32KSYS 
input-output processor. XORD, requires a number (PUN, 
or program unit number) in every order specifying 
the reel to be processed, symbolic tape names must be 
assigned to PUN's. 

There are two methods of assigning a symbolic name to 
a PUN externa] and internal. The external method im¬ 
plies that the PUN ultimately appearing in the input-output 
order has been selected externally, and has not been pre¬ 
determined by the programmer. The internal method im¬ 
plies that the PUN appearing in the order has been pre¬ 
determined by the programmer. 

The external method requires that the object program per¬ 
form certain functions during its execution. These are: 

• Given a symbolic name for a tape, ask for a PUN to 
be associated with this name via the SYS subroutine 

J TAPENO. 

• Insert the PUN into the input-output order. 

• Execute the order. 

The symbolic 'ape name is either a program parameter 
compiled with the program, entered as data, or gener¬ 
ated. This name must correspond to a unique reel of 
tape d urinK the running of the program. It is not desira¬ 
ble to specify a specific reel number at compile time; 
therefore, if the tape name is compiled with the program, 
this name is usually a functional designation, e.g., an 
input tape might he designated as INPUT. The specific 
reel identification is then associated with this symbolic 
tape name by the use of the TAPES control instruction at 
job time. For example, let the desired input tape be reel 
number 1 02 34. Then, execution of the following control 
instruction will relate INPUT to 1-0234: 

TAPES 1-0234, INPUT 
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INTERNAL 

ASSIGNMENT 


PUN'S 

PERMITTED 


SYS PUN'S 


RULE 


This method has the advantage that if the input reel num¬ 
ber is different on the next execution of the object pro¬ 
gram, only the TAPES control instruction card need be 
changed. 

The internal method requires that the PUN in an input- 
output order of a program be defined at compile time. 
When a program is written, a pre-determined PUN is 
placed in the input-output order, either directly, or sym¬ 
bolically (if a symbol, it must be defined with an ASGN 
card). The TAPES control card is used to relate the reel 
identification with the PUN. As an example, let the PUN 
chosen be 9, and let the reel identification of the tape used 
be 1-0234; then, execution of the following control instruc¬ 
tion, prior to the running of the object program, will make 
the proper association. 

TAPES 1-0234,9 

The pun's permitted to the user are the numbers 0 
through 15. Numbers 0 through 8 refer to specific sys¬ 
tem tapes, and if used will refer to the system tape des¬ 
ignated in the following table: 


PUN 

System Symbolic Tape Name 

0 

^^TSYSCRO 

(scratch tape) 

1 

TSYSTEM 

(system tape) 

2 

TSYSDMP 

(scratch tape) 

3 

L--TSYSCR3 

(scratch tape) 

4 

^_^YSCR4 

(scratch tape) 

5 

TSYSOUT 

(system output tape) 

6 

-UTSYSCRb 

(scratch tape) 

7 

TSYSLIB 

(system library tape) 

8 

TSYSIN 

(system input tape) 


The following rule must be observed: Any reference 
(via 32KXORD, or a 32KSYS Tape Handling function) to a 
PUN greater than 8 must be related to a symbolic tape 
name by a TAPES control instruction. 

Control will be returned to the system via IXCONER if 
the above rule is violated. 
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TAPES 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 

RESTRICTIONS 


REMARKS 


Relates a tape name (reel number) written on the joo 
sheet to the tape name used by the program. 


L 

Location 

Command 

Address and Remarks 

H 


TAPES 

par 1 (W), par 2 


par 1 - The symbolic tape name (e.g., a reel number 
"oj. system symbolic tape name) written on the job 
sheet to identify the tape reel to be mounted by 
the operator. 

(W) (OPTIONAL) - Indicates that par 1 is an output tape 
and must be write enabled- 

par 2 (OPTIONAL) - The symbolic tape name or program 
unit number by which subsequent programs refer to 
the tape reel identified by par, 1. 

H (OPTIONAL) - Indicates that par 1 is to be held for 
the next job (refer to IE'nDJOB), 

The tape tables within 32KSYS are updated to relate par 1 

to par Z. 

L If par 2 is a program unit number, it must be 9 thru 
15 and this must be the first appearance of par 1 
within the job. 

2. If par 2 is a symbolic tape name, this must be its 
first appearance within the job 

1. The TAPES control instruction pertains to the cur¬ 
rent job only. 

2. par 1 is typed on the console typewriter by 32KSYS 
for tape assignment by the operator (refer to 
Operating Procedures). 

3. The (W) parameter enables 32KSYS to distinguish 
between legal and illegal write orders to a tape that 
is not write enabled. However, 32KSYS does not 
distinguish between legal and illegal write orders 
to a tape that is write enabled, 

4. If par 2 is omitted, subsequent programs may refer 
to the tape reel by par 1 . 





RELEASE 


FUNCTION 

FORMAT 


PARAMETERS 

ACTION 


REMARKS 


Releases a symbolic tape name from its assignment. 


L 

Location 

Command 

Address and Remarks 



RELEASE 

_t j 1 • •. 


ll» • • = Symbolic tape names, only. 

Execution of the RELEASE control instruction initiates 

the following action: 

e The tape nameCs) specified are released from their 
specific assignments by removing the name(s) from 
the tape name list. 

• The tape(s) associated with the tape name{s) released 
may or may not be rewound with lockout. A tape is 
rewound with lockout if the released tape name was 
the only reference to the tape. 

1. Any tape name not in the tape name list will be ig¬ 
nored. 

2. System tape names will be ignored. 

3. A numeric designation will result in a control line 
error. 
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SECTION III 
SYSTEM TAPES 


Normal 32KSYS use requires nine 
magnetic tape units which the oper¬ 
ator assigns to the following sym¬ 
bolic tape names when needed. 
(Refer to Operating Procedures, 
Appendix A.) 
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TSYSTEM 


FUNCTION 


TSYSTEM - System Program Tape 


TSYSTEM is the System Program Tape, containing 
32KSYS in image form and System Routines, e.g. , 
TAG, RPLC, TACSERV, COBOL, etc. . in RPL 
form. 
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TSYSpMI 


FUNCTION 


RElvtARKS 


TSYSDMP - System Scratch Tape 


TSYDMP is a System Scratch Tape used by; 

• 32KSYS as an intermediate tape for dumps 
and snaps. 

• TAG, ALTAC, COBOL. REPORT GENERATOR, 
and ALTAC3X as a scratch tape. 

TSYSDMP is rewound when a JOB control instruction 
is encountered. 



TSYSIN 


TSYSIN - System Input T^e 


FUNCTION 


REMARKS 


The System Input Tape contains 32KSYS control 
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12 cards per block) or Image Mode (20 words per card, 
6 cards per block)- 


If desired, a special mixed image/code format may be 
used. A mixed mode System Input Tape is constrained 
as follows: 


a. The two indicator cards, IMGEIMGE and 
CODECODE, specify the mode of the card 
immediately following the indicator card. 

b. All JOB cards, IMGEIMGE cards, and 
CODECODE cards must be on tape in code 
mode. 

c. The JOB card must contain JOBAAAAA in the 
command field. 

d. No restriction is placed on the positioning within 
a block of an image mode card except no image 
mode card may straddle a physical block. There¬ 
fore, an IMGEIMGE card must be used to fill the 
last 10-word item of a block when the crossover 
would occur. 

e. The JOB card, in addition to its normal functions, 
also performs the same function as the 
CODECODE indicator card. Therefore, cards 
immediately following the JOB card are assumed 
to be in code mode until an IMGEIMGE card is 
encountered. 



TSYSOUT 


TSYSOUT - System Output Tape 


FUNCTION 


FORMAT 


Data Select 0 


Data Select 1 


TSYSOUT ii the System Output Tape on which informa¬ 
tion is placed for off-line printing and punching. To 
use the tape, however, the programmer must adhere 
to the 32KSYS standards concerning the four modes of 
Data Select described below under FORMAT. 

It is used by 32KSYS to print: 

• Information to identify jobs. 

e All executed control instructions, 

e Error information. 

• Dumps and Snaps. 

It is used by all compilers to: 

• Punch binary card images. 

• Print edited output. 

The format of the various types of 32KSYS output, 
specified by the particular Data Select mode, is 
described as follows; 

Data Select 0 is used to identify blocks to be printed 
on the High-Speed Printer. The standard print plug¬ 
board setting is one-to-one. 

Data Select 1 is used to identify blocks for binary 
card punching in Image Mode (20 words per card, 

6 cards per block), with the Control Character SENSE/ 
IGNORE Switch of the Punched Card Controller set to 
IGNORE when these cards are punched. To aid oper¬ 
ators in separating binary decks and associating them 
with other output from the various jobs, 32KSYS pre¬ 
cedes each distinct deck with one card in which all 
rows of Columns 1 through 8 are punched. For the 
convenience of operators, any programs using the off¬ 
line punch features of TSYSOUT should state via the 
Console Typewriter the number and type of cards to be 
punched. 
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TSYSOUT 


ua.ta. oeieci t. 


Data Select 3 


Data Select 4 


WRAPUP 


i_><lteL ^ AO UOCCi tU AO^CiiirAXy - 

card punching in Code Mode (10 words per card, 12 
cards per block), with the Control Character SENSE/ 
IGNORE Switch of the Punched Card Controller set to 
IGNORE when these cards are punched. As mentioned 
previously, any program using the off-line punch 
features of TSYSOUT should state via the Console Type¬ 
writer the number and type of cards to be punched. 

Data Select 3 is used to identify blocks containing JOB 
accounting cards in Code Mode (10 words per card, 

12 cards per block). These cards contain the same 
JOB accounting information as appears in Data Select 
0, if an accounting clock is in the system. 

Data Select 4 is used to identify blocks containing data 
for the X - Y Plotter. 

Whenever the Wrapup function of 32KSYS is used by an 
operator, the following is written on TSYSOUT. 

• End-of-tape sentinels with unconditional stops in 

each of the following Data Select modes used by 

'K 7VCVC. 

1. In Data Select 0, this statement, edited for 
the High-Speed Printer, appears several 
times: 

THIS IS THE END OF THE TAPE STOP 
PRINTING 

It is followed by a page-eject. 

2. In Data Select 1, a block of filler 
characters (Octal 32) is edited for 
punching. 

3. In Data Select 2, ten words are edited to 
punch a Hollerith-Image card with the first 
and last rows of all columns punched. 

4. In Data Select 3, a block of filler characters 
(Octal 32) is edited for punching. 
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TSYSOUT 


5. In Data Select 4, the following operations 

for the X - Y Plotter are performed: 

a. The pen is raised and positioned 0, 5 
inches toward the top of the paper, and 
is then positioned at the left margin. 

b. The pen is lowered and a saw-toothed 
pattern with a 45° diagonal length of 
1.12 inches is drawn from left to right. 

c. The pen is raised and positioned 1. 26 
inches above the saw-toothed pattern. 

• A sentinel block of Z's is then written, and the 
tape is rewound with lockout. 

Whenever end of tape is sensed, the tape assigned to 
TSYSOUT is rewound with lockout and a new assign¬ 
ment requested for TSYSOUT. 



TSYSLIB 


FUNCTION 


TSYSLIB - TAG Library Tape 


TSYSLIB is the normal TAG Library Tape. 
Subroutines should be in relocatable binary format 
because the tape is automatically searched by 32KSYS 
when a REL. . . .SUBS call is encountered. 

In general, TSYSLIB contains the various macro* 
instructions, generators, and relocatable binary sub¬ 
routines that are available to the programmer. 



TSYSCRO 


FUNCTION 


REMARKS 


TSYSCRO - System Scratch Tape 

TSYSCRO is used as a scratch tape by TAC, 
COBOL, REPORT GENERATOR, ALTAC, and 
ALTAC3X. 

TSYSCRO cannot be assumed to be in a rewound 
position. 
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TSYSCR3 


FUNCTION 

REMARKS 


TSYSCR3 - System Scratch Tape 


TSYSCR3 is used as a scratch tape by i AC, COBOL, 
REPORT GENERATOR, ALTAC and ALTAC3X. 

TSYSCR3 cannot be assumed to be in a rewound 
position. 
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TSYSCR4 


FUNCTION 


TSYSCR4 - System Scratch Tape 


TSYSCR4 is a System Scratch Tape used by: 

• TAG as a machine language output tape unless 
a PROGTAPE control instruction preceded the 
TAG control instruction. 

• ALTAC - same as TAG. 

• COBOL as a positioned scratch tape, (TSYSCR4 

is repositioned when the COBOL phase is finished) 
and as a machine language output tape unless a 
PROGTAPE control instruction preceded the TAG 
control instruction. 

• Report Generator - same as COBOL. 
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TSYSCR6 


FUNCTION 


REMARKS 


TSYSCR6 - System Scratch Tape 


TSYSCR6 is used as a scratch tape by TAG, COBOL, 
REPORT GENERATOR, ALTAC, ALTAC3X and 
ANALYZER. 


TSYSCR6 cannot be assumed to be in a rewound 
position. 



SECTION IV 


FUNCTION 


FEATURES 


32KSYS XORD 


32KSYS XORD, the 32KSYS input-output eubroutine, 

provides a simple means of issuing read, write, space, 

and rewind orders. 

The following are some of the features of XORD: 

• The XORD subroutine is contained within memory 
at all times. 

• 32KSYS and the 32KSYS programmer use XORD 
to execute magnetic tape orders. 

• Single and multi-block read, write, and space 
orders can be issued. 

• Rewind and rewind-with-lockout orders can be 
issued. 

• Order checking is automatic. For example, 
issuing a tape order causes automatic checking 
of any outstanding order for the unit. 

• In many instances, job restarts or cancellations 
are eliminated. For example, if a unit is in 
local, XORD allows the operator to put the unit 
in remote and continue the program. 

• In many cases, successive orders for the same 
tape are executed before tape movement stops. 

• Normal use of XORD results in the order being 
processed by the Input-Output Processor (lOP) 
when the exit occurs. 



ENTRANCES 
TO XORD 


CHECKING 

ORDERS 


EFFICIENT USE 
OF XORD 


The subroutine XORD has the following entrances: 

• MXORD - an entrance for executing single and 
multi-block orders, and rewinds. 

e XORD - an entrance for executing single-block 
orders and rewinds. 

e CHKORD - an entrance for checking orders. 

e SETXORD - an entrance for establishing a new 
error exit or cancelling a previously established 
one. 

e XTAPE - an entrance for obtaining the logical 
tape unit number. 

• SPORD - an entrance for executing an MXORD 
order and establishing an error exit effective 
only for the MXORD order. 

• CLORD - an entrance for eliminating an out- 
standing order, regardless of its status. 

For XORD, "checking an order" means "forcing the 
order to completion without errors." To achieve 
this, XORD takes corrective action when errors occur 
and/or calls for operator intervention if necessary. 

(A Rewind or a Rewind with lockout order is considered 
complete when accepted.) 

There are three methods available to the programmer 
for checking an order. These methods are listed below 
according to their probabilities of eliminating start- 
stop tape time: 

• Issue another order to the unit. 

• Issue a CHKORD call. 

• Set bit 17 of the Input-Output order word. 

Whenever possible, outstanding orders should be checked 
by issuing another order to the unit, as this minimizes 
the over-all computer time used by XORD. and offers 
the greatest probability of eliminating start-stop time. 
When a single input-output area is used, it is usually 
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best to call on MXORD with bit 17 set to zero, continue 
processing which does not reference the input-output 
area and then call on CHKORD. 

Bit 17 set to one should be used only if the programmer 
would otherwise issue a CHKORD call almost immedi¬ 
ately after an XORD or MXORD call. 



MXORD 


THE MXORD 
ENTRANCE 


MXORD - Execute Order (s) 


To execute a read, write, space, or rewind order 
either of the following calls may be used; 


L Location Command 


S MXORD 

or 

TMA 

IMP 


Address and Remarks 
ord $ 
ord $ 

SYS. IMXORD $ 


where ord is an input-output order word with the 
following format; 


Bit Setting Indication 


0 0 Indicates a read or write order. 


1 Indicates a space order. (If bits 

40-47 denote rewind, this bit is 
ignored.) 

1-7 0 Not decoded 


12-15 


The number of blocks (1-15) to be 
written, read, or spaced. 


16 0 Indicates that the order must be 

acce pted before exiting. 

1 Indicates that the order need not be 

accepted before exiting. 


17 0 Indicates that XORD is to exit immedi 

ately after the order is accepted. 

1 Indicates that XORD is to exit immedi 

ately after the order is complete. 


18-23 


PUN (Program Unit Number). 


24-39 


Core Starting Address. This address 
may be indexed. 
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MXORD 


STEPS TAKEN 
IN ISSUING 
ORDERS 


Bit lb 


Bits Setting Indication 

40-47 The Input-Output command, which 

must be one of the following: 

H/91 Read forward 
H/Dl Read backward 
H/19 Write 
H/8A Rewind 
H/8B Rewind wit^i lockout 

XORD attempts to issue the order specified in the A 
Register. If the order is not accepted, XORD proceeds 
according to the setting of bit 16 of the A Register. If 
the order is accepted. XORD proceeds according to the 
setting of bit 1 7. 

If the order is not arc epted, anti 

• If bit 16 is one, XORD returns to the calling program 
without taking further action. (The contents of the 

A Register will have been made negative. ) 

• If bit 16 is zero, XORD will force acceptance of the 
order and then proceed according to bit 17 (see 

Bit 17 below). The A Register will be positive when 
XORD returns to the calling program. 

The following actions are taken, as required, to force 
acceptance of the order: 

• In the event of a condition which XORD cannot cor¬ 
rect (for example, unit in local or missing write¬ 
ring) operator intervention is requested by a type- 
out. 

• If a previous order to the specified unit is being 
executed, XORD waits until that order is completed 
without errors. If XORD detects an error while 
waiting, appropriate action is taken to correct the 
error. 

• If all assemblers are busy because of orders 
previously issued to other units, XORD takes the 
appropriate action to free an assembler. 
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MXORD 


If the order is accepted (see Bit 16), bit 17 is inter¬ 
rogated: 

• If bit 17 is zero, XORD returns to the calling 
program while the order is still being processed 
by the lOP. 

• If bit 17 is one, XORD completes the order before 
returning to the calling program. Error corrective 
action is taken if necessary. 

The following table shows the effect of various settings 
of bits 16 and 17: 


Bit 16 Bit 17 Conditions on Return to 

Calling Program 

0 0 lOP is processing order. Contents 

of A Register are positive, 

0 1 Order is complete. Contents of A 

Register are positive. 

^ ® If Contents of A Register are positive, 

Input-Output Processor is processing 
order. 

If contents of A Register are negative, 
order was not accepted. 

I I If contents of A Register are positive, 

order is complete. 

If contents of A Register are negative, 
order was not accepted. 


STATUS OF 
REGISTERS 
ON RETURN 


When control is returned to the main program from 
XORD, Registers A, Q, and D have been altered. No 
index registers are altered, unless a CSA is indexed 
with a coxinting index, in which case that index will be 
incremented once. The A Register will be positive if 
the order was accepted and negative if not (see Bit 16). 
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XORD 


THE XORD 
ENTRANCE 


XORD - Executes Order 


To execute a rewind or a single-block read, write, or 
space order either of the following calls may be used: 


L Location 
S 


Command 


XORD 

or 

TMA 

JMP 


Address and Remarks 
ord $ 
ord $ 

SYS. IXORD $ 


where ord is an Input-Output order word. Except for 
the contents of bits 12-15, which must be zeros, the 
format of this Input-Output order word is the same as 
that used with the MXORD call. 

See MXORD entrance for steps taken in issuing orders. 
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CHKORD 


THE CHKORD 
ENTRANCE 


CHKORD - Checks an Order 


To check an order using the CHKORD entrance either 
of the following calls may be issued: 

L Location Command Address and Remarks 


S CHKORD unit $ 

or 

TMA unit $ 

JMP SYS.lCHKORD$ 


where unit is a word containing the program unit 
number in bits 18-23. 

XORD returns to the calling program when the out¬ 
standing order to that unit is completed without errors. 
If no order is outstanding for that unit, XORD returns 

A A A A A AU A ^ » 

Index registers are unaffected, the contents of Registers 
A, Q, and D are altered. 

The use of the CHKORD call does not guarantee that 
the next order for the unit will be accepted. The unit 
may be in local or the tape may be rewinding as a 
result of an outstanding Rewind or Rewind with Lockout 
order. 
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CLORD 


THE CLORD 
ENTRANCE 


CLORD - Terminates an Order 


To force termination of an outstanding order on a unit, 
regardless of its status, either of the following calls 
may be used: 


L Location Command 


S CLORD 

or 

TMA 

JMP 


Address and Remarks 
unit $ 
unit $ 

SYS. ICLORD $ 


where \init is a word containing the program unit 
number in bits 18-23. 

The CLORD call causes XORD to interrogate the unit 
and wait until the outstanding order is completed or 
terminated by errors (XORD does not wait for com¬ 
pletion of REWIND orders); a STOP order is then 
issued for the unit. 

A CLORD call should not be issued if the positioning 
of the tape or the status of the previous order to the 
unit is important. 
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THE XTAPE 

ENTRANCE 


XTAPE - Obtains Logical Tape Unit Number for PUN 


To obtain the logical tape unit number for the program 
unit number either of the following calls may be used: 


L Location Command Address and Remarks 

S XTAPE ui^ $ 

or 

TMA unit $ 

JMP SYS. 1 XTAPE $ 


where unit is a word which contains, in bits 18-23, the 
program unit nxunber. When XORD returns control to 
the calling program, the A Register contains the cor¬ 
responding tape unit number in bits 18-23. The other 
bits in the A Register will be the same as the corres¬ 
ponding bits in unit . Re gist©?® snd JA v^i.11 lisivs 

been altered on return to the calling program; however, 
no index registers are altered. 
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ERROR EXITS AND RECOVERY PROCEDURES 


32KSYS XORD hai two basically different error 
procedures: 

• A typeout/halt procedure which is used when no 
error exit has been specified (see below for 
further details). 

• An error exit procedure which requires that the 
user write an error exit subroutine and specify 
the address of the error exit subroutine by using 
SETXORD and/or SPORD calls. 

ERROR K no error exit subroutine address has been specified 

TYPEOUT/HALT and an error occurs, XORD types an error notice and 

then halts. Each error notice consists of the symbolic 
tape name, the logical unit number, and a message 
indicating the type of trouble. The following illus¬ 
trates the format of a full error notice: 

TSYSOUT TAPE 5 SI ERROR 

The following table lists the possible messages and 
their meanings. 


ERROR 

MESSAGES 

Message 

Meaning 

Suggested Oper¬ 
ation Action 


IN LOCAL 

Unit is mechani¬ 
cally unavailable. 

Place tape in remote 
and press advance. 


WRT NABL 

Unit should be 
write enabled. 

Write enable the 
tape and press ad- 
vanc e. 


ROCKED 

XORD has made 
repeated unsuc¬ 
cessful attempts 
to fix parity and/ 
or sprocket er¬ 
rors. (five erase 
resume actions 
for a write order; 
ten retries for a 

Dump job or press 
advance to retry. 
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ERROR 

MESSAGES 

(Continued) 

Message 

Meaning 

read order, five 
in each direction). 


ILL. WRT 

XORD has been 
told to write on 
a tape that is 
not write-enabled 
and should not be 
used as an output 
tape, 


PROG 

ERR 

The calling pro¬ 
gram has erred 
(possibly an im¬ 
proper XORD 
parameter) - 


SYS ERR 

The hardware is 
malfunctioning 
(possibly XORD 
program has 
been partially 
clobbered). 


DISABLED 

Unit became 
mechanically dis¬ 
abled while exe¬ 
cuting an order. 


BEG TAPE 

XORD has been 
told to process 
a block prior to 
first block on 
tape. 


END TAPE 

XORD has been 
told to process 
a block after 
last block on 

tape. 


SI 

ERROR 

A begin block 
mark has been 


missed. 


Suggested Oper¬ 
ation Action 


Dump job. 


Dump job. 


Dump job. 


Dump job. 


Dump job. 


Dump job. 


Dump job. 
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ERROR 
MESSAGES 
(Continued) 


Message 


Meaning 


SZ An end blockmark 

ERROR has been missed. 


BAD FIX A serious error 

has occurred while 
XORD was trying 
to fix parity and/ 
or sprocket errors. 


FAULTY Some combination 
of faults has oc - 
curred or the hard¬ 
ware is malfunc¬ 
tioning , 


Suggested Oper 
ation Action 

Dump job. 

Dump job. 

Dump job. 



SETXORD 


THE SETXORD 
ENTRANCE 


SETXORD - EaUbllsh«« Error Exit 


An error exit may ba •■tabiiehad by either of the 
following two calls: 


L Location Command 

S SETXORD 

or 

TMA 

JMP 


Address and Remarks 


param $ 


aram $ 

V§. ISETXRD $ 


where param is a word which has the following form: 

P/ERRORX, F40$ 

ERRORX is the address of an error exit subroutine and 
must not be an indexed address. The error exit sub- 
rovitins tHus sp^cifisd will usf^ci for sill orders not 
issued with SPORD calls until another SETXORD call 
is given to XORD. A aero error exit address indicates 
that no error exit subroutine is available (except for 
orders issued with SPORD calls). At the beginning of 
each job the operating system issues a SETXORD call 
specifying a aero error exit address. 
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SPORD 


THE SPORD 
ENTRANCE 


SPORD - Establishes Error Exit for a Particular Order 


A special error exit address may be established (to be 
used for a particular order) by either of the following 
two calls: 


L Location Command 


S SPORD 

or 

TMA 

JMP 


Address and Remarks 

param $ 

param $ 

SYS. ISPORD $ 


where param is a word which has the following form: 

C/HLTL, CALLWORD,P/SPECIAL. ERRORX. F40 $ 

CALLWORD is the address of a parameter suitable for 
an MXORD call. SPECIAL ERRORX is the address of a 
special error exit subroutine which XORD will use if and 
only if trouble occurs due to the order in location CALL- 
WORD. The special error exit subroutine will not be 
used for troubles on other units or for errors attributable 
to the previous/next order to the unit specified in loca¬ 
tion CALLWORD (the typeout/halt procedure or the error 
exit subroutine specified by a SETXORD call will be used 
for these conditions). SPECIAL. ERRORX must not be an 
indexed address. 
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ERROR EXIT 


INTRODUCTION 


This discussion is applicable to error conditions other 
than unit mechanically unavailable and tape not write 
enauiea, wnicn always result in the typeout/halt action 
(see above). If trouble occurs and an error exit sub¬ 
routine has been specified (see SETXORD and SPORD 
calls) XORD saves information required for restarting, 
which could be clobbered by calls on XORD, and sets a 
switch to prevent the clobbering of this data in the event 
of a subsequent error exit. In the following description 
this switch is referred to as XSWITCH, It is assumed 
that the error exit subroutine is entered via the following 
coding 


L Location Command 

RETURNA JMP 
RETURNS JMP 
ERRORX TJM 
TJM 
INCA 


Address and Remarks 

(P) $ 

(P) $ 

RETURNA$ 

RETURNS! 

RETURNS! 


CONDITIONS 
ON EXIT 

O Register 


A Register 


The following information is available to the error exit 
subroutine when it is called by XORD. 

The last order (in MXORD format) issued by XORD to 
the unit in trouble. Sits L6 contain the program unit 
number and bits 20-23 contain the logical unit number. 
The core starting address, if applicable, reflects index- 
any This order is not involved in the trouble 
w'hich resulted in XORD calling on the error exit sub¬ 
routine if the status w'ord indicates no Input- Output 
Processor faults. 

An XORD status word for the unit in trouble. Sits are 
set as described below: 

Meaning 

Undefined. 

Sad fix (serious trouble while fix parity/ 
sprocket error) 

Undefined 


Sits 

0 

1 

2-3 
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ERROR EXIT 


Bits Meaning 

4 Rocked (too many parity/sprocket fix attempts). 

5 , Program error (possibly an improper XORD 

parameter). 

6 Disabled transport. 

7 SI error. 

8 S2 error. 

9 Sprocket error. 

10 Illegal write order li bit 5 is set otherwise lOP 

malfunction. 

1 1 Parity error 

12 lOP malfunction. 

13 Begin tape 

14 End tape 

1 5 Space fault 

16- 19 Undefined 

2 0--23 Numbe r of blocks remaining to be processed 

as indicated by assembler counters. 

24-45 Undefined. 

46 Same as bit 1. 

47 Same as bit 4 

Indexed Table A table of connectors and error recovery data used 

XORD and available to the error exit subroutine subject 
to the constraints listed under Error Recovery Rules, 

Location Contents 

00, IX C/JMP, XORD. FINIS: C/JMP, XORD. EX1T$ 
where XORD. FINIS is the address of coding 
which restores main -program (program which 
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ERROR EXIT 


Location 


01 IX 

02 IX 

03, IX 
04, IX 


05. iX 
07, IX 
08. IX 


Contents 

called XORD) index registe rs IX and 2X and 
then returns eontroi to the main program 
aORD. EXIT IS the address ot the JMP com¬ 
mand which returns control to the main pro¬ 
gram. (Neither ol these JMP commands is 
to be used without first executing JMP 9, 1$' 
The contents of Registers A and Q are no’ 
altered by use cf these JUMP comn < r,H' 
indicators can be given to the main pre^i - 
via A and O 

Ciurrent callword in MXORD format The cio-e 
starting address if applicable reflects index 
1 ng if any The program unit number appear^ 
in bus 1 6 a well in bits 18 23 

Main program index registers IX and 2X The 
contents of 1 X are in the left address with the 
C. Bit scaled at Tib; the contents of 2X are in 
the right address, ■vc'ith the C Bit scaled at T-D 


Undefined 

Input Output Processor order in machine lan¬ 
guage format which XORD is c iirrently tryinfj 
to issue. This word is D/0$ if XORD is cur¬ 
rently checking an order CHKORD call or final 
phase ol XORD / MXORD/SPOR D call with hii 
17 set to zero) rather than trying to issue .m 
order. 

U n (i e f 1 n f' d. 

Undefined 

Entrance to XORD typeout suoroutine, JMPL 
08 1X$ will result in XORD typeout of an error 
notice follow'ed by return of c ontrol to the com 
mand following the JMPL 08 1 X$ instruction 
The contents of IX will not be altered. See 
TYPEOUT/HALT for the possible error notices 
which may occur If for example the error 
exit was due to an end of tape error for symbolic 
tape PTLE 04, logical unit nuxnber 12, the JMPL 
08, 1X$ the instruction would t i.ist the follow 
ing typeout; 

F'lLE 04 TAPE !2 BUG I'APF. 


1 - 1 H 



ERROR EXIT 


ERROR RECOVERY 
RULES 


ADDITIONAL 

ERROR 

RECOVERY 

INFORlvlATION 


Location Contents 

09, IX Entrance to an XORD subroutine which resets 
XSWITCH (see above). If XORD is not re¬ 
started via RETURNA or RETURNS, a JMPL 
09, IX must be executed. Control will be ret ■ 
urned to the command following the JMPL 
09, 1X$ instruction with the contents of A,0, 
and all index registers unaltered. 

The data described above may be used by the error exit 

subroutine subject to the followung rules: 

1. No part of the table indicated by the contents of IX 

may be altered. 

2. A JMPL 9, IX must be executed if XORD is not re 
started via RETURNA or RETURNB. 

3. If corrective action involving calls on XORD itself 
is taken, a JMPL 09, iX$ instruction must not be 
executed prior to any of these calls. 

4. If XORD or MXORD calls are issued, another error 
exit may result. Therefore, it is advisable to use 
SPORD calls in the error exit subroutine, specifying 
special error exit addresses within the error exit 
subroutine itself. 

The following information will probably be of use in 

writing an error exit subroutine. 

1. When XORD calls on an error exit subroutine, the 
unit in trouble is available if bit 6 is zero and the 
transport is not disabled. XORD has waited for the 
tape to stop and has issued a STOP order. 

2. When XORD calls on an error exit subroutine, at 
least one assembler is available. 

3. Unlike previous versions of XORD, an error exit 
subroutine is not called unless the trouble involves 
the unit specified by the current call on XORD. 

4. JMP RETURNA will result in the normal XORD 
TYPEOUT/HALT action. XORD will pretend that 
it never called the error exit subroutine. 
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ERROR EXIT 


5. JMP RET’IJR.NBJ will result in restarting XQRD 
as though the trouble and subsequent call on the 
error exit subroutine had not occurred. 


It the contents of the A Rigisitr are not zero when 
JMP RETURNB$ is execuredj XORD will assume 
that the A Register contains an order which is to 
replace the order outstanding for the unit in trouble, 
This order must be in the same format as the con¬ 
tents of the O Register on entry to the error exit 
subroutine. XORD assumes that this order has 
been issued by the error exit subroutine and it is 
used by XORD tc update its list of outstanding orders. 
Use of this feature is not required if the error exit 
subroutine uses XORD to issue orders. 


6. If an error exit occurred because a tape was 

ROCKED (bit 4 or bit 47 of status word is set to 
one), the following is applicable: 


a. 


For a write order, an erase 
- 


licio dlieclUl 


b. For a read order, XORD has issued and com¬ 
pleted a reverse read order. The block in¬ 
volved in the parity/sprocket trouble will be 
the next block processed or spaced over, if an 
order (specifying the original direction) is 
issued to the unit. 


7. When an error exit occurs, the address of the unit 
in trouble is not necessarily contained in the unit 
address register of an assembler. This means 
that while Class A orders and rewind orders will 
be accepted because an assembler is free and a 
stop has been issued to the unit in trouble. Class 
B and C orders may not be accepted. 
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SECTION V 


CONTROL LINE FUNCTIONS 


SOURCES OF 

CONTROL 

LINES 


CONTROL 

LINE 

FORMAT 


The fundamental operations of 32KSYS, such as loading 
programs into memory, reading and writing on tape, 
and starting and stopping runs, are called into action 
by 32KSYS Control Lines - each consisting of a control 
instruction and its parameters. 

A Control Line must be written in a format similar to 
that for TAC instructions and may be entered into the 
computer from either of the following sources: 

• Cards via the 32KSYS input tape 

• Console Typewriter (manually). 

The format for 32KSYS Control Lines is illustrated 
below, indicating the location of columns, fields, and 
Console Typewriter tab settings, including the left 
margin for the typewriter. 


FIELDS 


COLUMNS 



CONSOLE TYPEWRITER TAI SETTINGS 





























Information shotild be written within each field as follows: 


REMARKS 


• Label Field (Column 9). An L or an R normally 
placed in this field indicates whether the left or 
right half of an instruction or an address is to be 
acted upon by a control instruction. 

For the Console Typewriter, the single character is 
entered before the first tab setting following a 
carriage return. 

e Location Field (Columns 10-16). Normally the octal 
address of an instruction or data to be acted upon by 
a control instruction is placed in this field. 

For the Console Typewriter, information for this 
field is to be entered between the first and second 
tabs following a carriage return. 

e Command Field (Columns 17-24). The control line 
command is to be placed in this field. 

For the Console Typewriter, the field is between 
the second and third tabs following the carriage 
return. 

• Address and Remarks Field (Columns 25-80). The 
parameters are to be written in this field in the 
following manner; 

1. Parameters must be separated by break charac¬ 
ters, i.e., acomma(,), semicolon {;), period 
(.), or slash (/). No distinction is made between 
these characters, except where otherwise noted. 

2. The last parameter must be followed by a dollar 
sign if remarks are to follow. 

For the Console Typewriter, information for the 
Address and Remarks field is to be entered following 
the third tab. 

1. If any control line command is illegal or, in general, 
if any of its parameters are illegal, an error type- 
out will bo typed on the Console Typewriter, unless 
otherwise noted, and control is transferred to 
IXCONER. 
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WRITING 

CONTROL 

LINES 


2. If a control line error has occurred while entering 
control lines from the Console Typewriter, a JOB 
control instruction must be entered to clear 32KSYS 
of the error condition. 

3. Upon completion of successful action of control in¬ 
structions, control is generally transferred to the 
32KSYS entry INXTCON, which requests and 
attempts to execute the next control instruction. 

4. The Philco Coding Form is provided for the user's 
convenience in writing his programs. Philco 2000 
TAG cards are available for punching the information 
from the Coding Form. 

As indicated, the command word of 32KSYS control line 
is to appear in the Command field of a card, and the 
parameters are to appear in the Address and Remarks 
field. To simplify explanation of these lines, all capi¬ 
talized words which appear within the illustration of the 
instruction format below are to appear on the card 
exactly as shown. All underlined words in lower case 
are to be replaced - generally by an L or R in the Label 
column, an address in the Location field, and parameters 
selected by the programmer in the Address and Remarks 
Field. 

For example, the instruction LOCTACL is described as; 


L Location Command 


Address and Remarks 


LOCTACL t, id, sent 


CONTROL 

LIME 

FUNCTIONS 


Although commas are used in format examples throughout 
the manual, any of the acceptable break characters 
(, ; . /) are permissible except where otherwise noted. 

32KSYS control lines are grouped according to function 
into nine classifications. These functions, their meaning, 
and an example of a particular control instruction within 
each function are listed as follows: 



CONTROL 

LINE 

Function 

Meaning 

Example 

FUNCTIONS 

(Continued) 

Initialization 

Instructions used to pre¬ 
pare the System for 
compilations or runs. 

JOB 


Compilation 

Instructions used to call 
in the compilers and 
initiate source program 
conversion from mne¬ 
monic coding into machine 
language. 

TAG 


Loading 

Instructions used to load 
an object program into 
memory and initiate the 
running of the program. 

REL 


Segmentation 

Instructions used to divide 
a program into smaller 
segments to permit load¬ 
ing and running of only 
parts of the program in 
memory at a given time. 

SEGMENT 


Tape Handling 

Instructions used to read 
from, write onto, or re¬ 
wind magnetic tapes. 

READF 


Debugging 

Instructions used to aid 
the programmer in diag- 
nosihg and patching pro¬ 
grams which may be 
faulty. 

DUMP 


Special 

Instructions used to per¬ 
form miscellaneous func¬ 
tions on the computer, 
such as setting a pseudo 
toggle register, clearing 
memory locations, halting 
an operation, or trans¬ 
ferring control to a mem¬ 
ory location. 

SYSOPS 



CONTROL 

LINE 

FUNCTIONS 

(Continued) 


Function 


Service 

Routine 


Application 


Meaning 

Instructions used to call 
in routines whose func¬ 
tions are tape mainte¬ 
nance, debugging, and 
program monitoring. 

Instructions used to call 
in application systems 
which run \inder control 
of the 32KSYS monitor. 


Example 


RPLC 


PERT 
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SECTION VI 


INITULIZATION FUNCTIONS 


The JOB control instruction prepares 
the System for a new program, and 
the CONIN instruction specifies the 
source of control instructions. 



JOB 


JOB 


FUNCTION 


FORMAT 


PARAMETER 

ACTION 


Prepares the System for a new job or series of oper¬ 
ations and identifies the job. JOB is the highest level 
instruction in the 32KSYS hierarchy; therefore each job 
must begin with a JOB control instruction. 


L 

Location 

Command 

Address and Remarks 



JOB 

ident 


ident - 16 or fewer alphanumeric characters which 
identify the job to be processed. 

Execution of the JOB control instruction initiates the 

following action: 

• TSYSDMP is rewound. 

• Ail tapes except those assigned to System names or 
those assigned to names held for the next job (refer 
to TAPES Instruction) are rewound with lockout. 

• All symbolic tape names except System names and 
those held for the next job are released. 

• An end-of-job message is written on TSYSOUT. 

• The RPL, REL, and ABS loaders are reset, i.e., 
common origin is reset to 10000 0 , common storage 
area reset to 0 , etc. . 

• The DUMP control instruction table and the CONBIT 
word are cleared. 

• The indicator words IIBIT and ISYSOPS are cleared. 

• Memory is cleared from location lOOOOg to the end 
of memory. 

• The effective end of memory is reset to 77777 g. 

• All index registers except 1 and 2 are cleared. 

• The System jump vectors are reset. 


o-£. 





JOB 


• The JOB card is typed on the Console Typewriter. 

• The date and time from the Accounting Clock are 
typed on the Console Typewriter. 

js The edited coding for the JOB page is written on 
TSYSOUT for printing. 


* Only those characters which are upper case characters of the Console 
Typewriter should be used. 
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3NIN 


CONIN 


UNCTION 


ORMAT 


'ARAMETER 


ACTION 


Specifies a new mode of input. 


L 

Location 

Command 

Address and Remarks 



CONIN 

mode 


mode - One of the following must be selected; 


code: - Indicates that the next 32KSYS control instruc¬ 
tion is in Code Mode, 


image: - Indicates that the next 32KSYS control instruc¬ 
tion IS in Image Mode. 

Whenever CONIN is executed. 32KSYS expects to receive 
its next control instruction in the mode specified by 
mode. 


i. ^ A 




SECTION VII 


COMPILATION FUNCTIONS 


This group of control instructions 
specifies the type of compilation to be 
made using 32KSYS as an executive 
routine. 



TAG - Translator-Assembler-Compiler 


rAC 


FUNCTION 

FORMAT 


PARAMETERS 


InitiateB a TAC compilation 


L 

Location 

Command 

Address and Kemarks 


format 

TAC 

source, lib, subs, 

NOCARDS, NOPROG 


format - The format in which the program is to be com 
^ed. If omitted, REL is asBumed. 


REL - IndicateB relocatable binary card format. 

ABS - Indicates absolute binary card format. 

RPL - Indicates tape (running program language) 
format. 

source - The source of the TAC language program. If 
omitted, TSYSIN is assumed. 

MAGTAPE - Indicates that the source is the system 
input tape, TSYSIN. 

MAGTAPE, ^ - Indicates that the source is the 
symbolic tape, U 

lib (OPTIONAL) - Indicates that subroutines are to be 
included in the object program. 

lib, t,_t - Indicates 1-7 symbolic tapes to 

^ be used as sources for the sub¬ 
routines to be copied. If only 
LIB is specified, the system 
library tape, TSYSLIB, is as¬ 
sumed. 

subs (OPTIONAL) - Indicates whether subroutines from 
“““the TAC library are to be compiled with the program. 

SUBS - Indicates that subroutines arc to be compiled. 
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TAC 


ACTION 


REMARKS 


NOSUBS - Indicates that no subroutines are to be 
compiled. 

Note; If omitted, RPL and ABS compilations assume 
SUBS: REL compilations assume NOSUBS. 

NOCARDS - Indicates that no cards will be produced on 

TSYSOUT for REL and ABS programs. 

NOPROG - Indicates that the machine language program 

will not be produced on the System's or User's Pro¬ 
gram Tape. 

s The TAC language program is compiled and machine 
language output, a Code-Edit, and edited cards for 
punching (if format were ABS or REL) are created. 

• The machine language output is produced on the 
System's or the User's Program Tape unless the 
NOPROG parameter was specified or compilation 
errors were detected in the source program. If 
there were compilation errors, the compiler re¬ 
stores the Program Tape to its position at the start 
of the compilation. A block of Z's is written on the 
Program Tape and the tape is positioned immediately 
prior to that block of Z's. The Code-Edit is pre¬ 
pared and written on TSYSOUT for off-line printing 
on the High-Speed Printer in Data Select 0. 

• The edited cards are produced on TSYSOUT for off¬ 
line punching in Data Select 1, unless the NOCARDS 
parameter was specified. 

1. If a TAC compilation is successfully completed, the 
compiler returns to the system via SYS. INXTCON, 
where the next control instruction is executed; 
otherwise it returns via SYS. ICOMPER where the 
remaining control instructions in the JOB are 
investigated. If the control instruction is one of 
the following, it is executed; otherwise a search 
for the next JOB is initiated. This process continues 
until a JOB instruction is encountered. 
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TAG 


ALTAC 

ALTAC3X 

CLOCK 

COBOL 

FORTRAN 


HLT 
IB IT 
JOB 

LOCTACL 

NOPRINT 


OPAL 
PRINT 
RELEASE 
REM 
REPORI 


REWIND 

REWINDLO 

SYSOPS 

TAC 

TA.PES 


Z. If a serious tape error is detected during a compila¬ 
tion and the operator returns control to the system 
via memory location 1, the Program Tape is re¬ 
stored to its position at the start of the compilation. 

3. The 32KSYS control instruction, SYSOPS, offers 
the programmer a means of supplying the TAC com¬ 
piler with optional modes of operation. 

4. Edited cards for punching are produced on TSYSOUT 
even if compilation errors were detected, unless 
NOCARDS was specified as a parameter. 

5. An asterisk in the Address and Remarks field of the 
TAC control instruction indicates that the TAC 
language input is on TSYSIN and the library to be 
used is TSYSLIB. An asterisk is equivalent to 
MAGTAPE, TSYSIN. LIB, TSYSLIB. 

6. A blank Address and Remarks field in the TAC 
control instruction indicates that the TAC language 
input is on TSYSIN and there is no library tape. 

This is equivalent to MAGTAPE, TSYSIN. 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 


Message 


Explanation 


ID IS ^ Start of compilation, where W is the 

program identity. 


nnnnCRDS 


End of ABS or REL compilation, nnnn 
is the number of cards produced on 
TSYSOUT. 


nnnnB LKS End of successful RPL compilation. 

nnnn is the number of blocks on the 
Program Tape. 
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TAG 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 

(Continued) 

Message 

ENDCMP 

Explanation 

End of successful compilation and the 
programmer specified NOPROG (in case 
of RPL) or NOCARDS (in case of ABS 
or REL). Control is returned to the 
operating system via SYS. INXTCON. 

CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 

Message 

TAPE t 

BAD lTb 

Explanation 

Table of contents of library tape is not 
acceptable. Compiler exits to 

SYS. ICOMPER. 


TAPE t 

NO LIB 

Tape t is not a library tape. Computer 
halts. 


GENERR 

Either library or generator error or 
insufficient parameters in generator 
call. Generation is terminated and 
compilation continues. 


nDMPTAC 

Machine or compiler error. Computer 
Halts, n indicates the compiler pass 
where error was detected. 


CMPERRS 

Source program error detected. The 


rompiier rebtores tlie Program Tape 
to its position at the start of the com¬ 
pilation (before a block of Z's). 
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ALTAC 


ALTAC - Algebraic Translator into TAG 


FUNCTION 

FORMAT 


PARAMETERS 


REMARKS 


Initiates an ALTAC III compilation. 


L 

Location 

Command 

Address and Remarks 


format 

ALTAC 

source, lib, subs, 
NOCARDS, NOPROG, 
NOTAC 


The parameters for ALTAC are the same as for TAC 
except for the additional NOTAC parameter. 

NOTAC (OPTIONAL) - Indicates the TAC assembly 
phase of the compilation is to be bypassed. The 
generated TAC program is on TSYSCR6. 

For a complete description of the parameters, action, 
and typeouts that can occur during an ALTAC compilation 
refer to the TAC description. 

The following error typeouts can occur during an ALTAC 
compilation in addition to those described under TAC: 


CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 


Message Explanation 


EALTAC A source language error has been 

detected that would cause generation 
of an incorrect object program. The 
TAC assembly is bypassed and control 
is returned to SYS via SYS. ICOMPER. 


n 


c 






ALTAC3X 


ALTAC3X - A Fast Corapilf-and-Go Version of ALTACIII 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


Initiates an ALTAC3X compUation. 


L 

Location 

Command 

Address and Remarks 


ABS 

ALIACiX 

source, lib 


ABS 18 the only format in which the object program of 
an ALTAC3X compaatior *8 produced. 

For a complete description ot the parameters refer to 
the TAG description. 

Execution of the AETAC3X control instruction initiates 
compilation of the source program, creation of cards, 
and the following printer output on TSYSOUl: 

• The listing ol the source program 

• The identities of the LIBRARIES USED 

• The ASTORS resulting from DlMENSiON state¬ 
ments and ASTORS in a TAG insert. 

• The PROGRAM MAX mdu ating the next available 
ni'^mory location following the program 

• The address where POOL GONSTANTS begin 

• The END CARD jUMf> ADDRESS 

• A sorted SYMBOL TABLE containing statement 
numbers, names of variables, and symbols. Except 
for symbols of the form nnnnnS N (where nnnnn 
represents a statement number), symbols beginning 
with a numeric character are not printed. 


The number of ABS cards produced including the 
dummy PM AX card. 




ALTAC3X 


REMARKS 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 

CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 


• The machine language output is produced on the 
System's or the user's Program Tape unless 
compilation errors were detected in the source 
program. If there were compilation errors, the 
compiler restores the Program Tape to its position 
at the start of the compilation. 

1. ALTAC3X differs from ALTAC III as follows; 

a) ALTAC3X does not produce an edited listing 
of the object program. 

b) ALTAC 3X produces ABS output only, and 

c) ALTAC3X source programs may not include 
relocatable binary decks. 

2. ALTAC3X comprises the three RPL programs: 

PHASE 1: A modified version of the ALTAC III 
translator, 

PHASE 2: A modified version of the first pass 
of TAC, 

PHASE 3: A modified version of the second pass 
of TAC 

3. Remarks 1 and 2 in the TAC description also apply 
to ALTAC3X, 

Refer to typeouts and explanations in the TAC description. 


Message Explanation 


CMPERRS Source program error detected. 

Compilation ends, no object program 
is produced, and control is returned 
to the operating system via SYS. 
ICOMPER. 


GENERR 


Either library generator error or in¬ 
sufficient parameters in generator call. 

Generator is terminated and compilation 
continued. 
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ALTAC3X 


CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 

(Continued) 


PRINTER 

ERROR 

INDICATIONS 


Message Explanation 

MCHERRn Machine or compiler error. Computer 
halts with the address field of the HLT 
instruction representing the location 
where phase n detected the error. 


TAPE n Tape n is not a library tape. Computer 

NO LIB halts. 


TABOVER TAC symbol table over-flow. Compila¬ 
tion ends, no object program produced, 
and control is returned to the operating 
system via SYS. ICOMPER. 


TAPEn Table of contents of library tape n is 

BAD LIB not acceptable. Control is returned to 

the operating system via SYS. ICOMPER. 


Errors on the Printer output are indicated as follows, 
depending upon the compiler phase in which the error 
was detected. 


• Source program errors detected during the first 
phase of the compilation are indicated in the source 
program listing, and compilation ends after the 
first phase. 

• Errors detected in later phases are indicated in 
octal in the word ERRINDS. The bits of this word 
are interpreted as follows; 


Bit Significance 


0 LABEL FIELD ERROR 

1 COMMAND FIELD ERROR 

3 AMBIGUOUS OR CONFLICTING F-BITS 

4 LOCATION FIELD ERROR 

5 DOUBLE ASSIGNMENT 

8 ADDRESS OF NEXT INSTRUCTION CYCLES 
MEMORY 

9 ILLEGAL CONSTANT PREVIOUS CARD 

10 ADDRESS FIELD ERROR 

11 TOO MANY NAMES. NONAME USED 

\Z NAME FIELD ERROR. NONAME USED 

14 CONTROL CARD ADDRESS FIELD ERROR 
18 END CARD ADDRESS ERROR 
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,TAC3X 


Bit Significance 

22 ILLEGAL CONTINUATION CARD 

23 CSA OF BINARY CARD IMPROPER, USED ZERO 

24 BINARY CARD xxxx BAD ( xxxx i* an identity 
and sequence number) 

25 DOUBLE ASSIGNMENT WOULD OCCUR IF 
SYMBOL WERE COMMON 

26 SET PARAMETER NOT PREVIOUSLY DEFINED 

37 8888 NOT DEFINED ( 8888 represents a symbol) 

40 IMPROPER REFERENCE TO INDEX REGISTER 
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COBOL 


FUNCTION 


FORMAT 


PARAMETERS 


REMARKS 


CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 


COBOL 


Initiatet a COBOL compilation. 


L 

Location 

Command 

Address and Remarks 


format 

COBOL 

source, lib, sub, 
NOCARDS, NOPROG, 
NOTAC 


The parameters are the same as those for the ALTAC 
control instruction. For a complete description, refer 
to the parameter explanations of TAG and ALTAC. 

The COBOL library may be mounted on a tape with the 
symbolic name COBOLIB instead of being combined 
with the regular TAG library (TSYSLIB). If COBOLIB 
is used for the COBOL library, bit 19 of the CONBIT 
WORD, 1 CONBIT, must be set to 1. The setting of 
this bit is an installation option. 


Message 


NO LIB 


ECOBOL 


Explanation 


A COBOL library required by the 
source program is not mounted on the 
correct tape. 

A source language error has been 
detected that would cause generation 
of an incorrect object program. The 
TAG assembly is bypassed and control 
is returned to the operating system 
via SYS. ICOMPER. 


MACHERR 


A machine or compiler error has 
occurred. 
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OPAL 


FUNCTION 


FORMAT 


ACTION 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 


OPAL - The Assembly Language for Philco 1000 


Initiates an OPAL assembly. 


L 

Location 

Command 

Address and Remarks 



OPAL 



Execution of the OPAL control instruction initiates the 

following action; 

• The OPAL language program is assembled and an 
object program and a code edit are created. 

• The format of the object program produced is 
dependent upon the OPAL "OPTIONS” control card 
which should immediately follow the I card. ABS 
(absolute binary) card format is the standard 
object program format produced by the assembler. 
The cards are edited for punching with data select 

1 and written on TSYSOUT. If the MAGTAPE para¬ 
meter is specified in the "OPTIONS" control card, 
the object program is produced in magnetic tape 
format (10Z4 characters per block). 

In this case the object program is written on 
TSYSCRO rather than on TSYSOUT. If the n para¬ 
meter is used, the program is written on tape n 
instead of on TSYSCRO. (A TAPES control card 
may be required.) The loader program produced 
by the assembler, when the MAGTAPE parameter 
is specified, occupies the first 168 characters of 
the first block. 

• The Code-Edit listing produced by the OPAL as¬ 
sembly is written on TSYSOUT, edited for printing 
with data select 0. 


Message Explanation 


ID IS id Program identity, represented by id, 

is typed out after the first source card 
is read. 




OPAL 


CONSOLE 

Message 

Explanation 

TYPEWRITER 

NORMAL 

PROGRAM 

The Object Program Tape is n_. This 

TYPE-OUTS 

TAPE IS n 

type-out does not occur unless the 

(Continued) 


program changes normal assignments 


nnnCRDS 

This type-out occurs at the end of the 
assembly for card output; nnn is the 
number of cards written on the Object 
Program Tape and/or TSYSOUT. 


CONSOLE 

TYPEWRITER 

Message 

Explanation 

ERROR 

INSUFFI¬ 

OPAL requires a minimum memory 

TYPE-OUTS 

CIENT 

MEMORY 

of octal 27000 to run. 


OPAL 

Assembler error or machine mal¬ 


ERROR 

function. 



REPORT GENERATOR 


REPORT GENERATOR 


FUNCTION 

FORMAT 


REMARKS 


Initiates a REPORT GENERATOR compilation. 


L 

Location 

Command 

Address and Remarks 


format 

REPORT 

source, lib, subs, 
NOCARDS, NOPROG, 
NOTAC 


For a complete description of the parameters, action, 
and typeouts that can occur during a REPORT GENER¬ 
ATOR compilation, refer to the TAG and ALTAC de¬ 
scriptions. 

The following error typeouts can occur during REPORT 
GENERATOR compilation in addition to those described 
under TAG: 


CONSOLE 

♦T* •\r T^TT' ^ir T> T n^TT 

i 1 w xvi X a. 

ERROR 

TYPE-OUTS 


Message Explanation 


EREPORT An excessive number (more than 255) 
of errors were detected in source pro¬ 
gram. 

The TAG assembly is bypassed and 
control is returned to 32KSYS via 
SYS. ICOMPER. 


MACHERR Computer halts. Generator program 
flow is in error because of machine 
failure. 
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FORTRAN 


FORTRAN 


FUNCTION 

FORMAT 


PARAMETERS 


Initiate* a FORTRAN IV compilation. 


L 

Location 

Command 

Address and Remarks 



FORTRAN 

source, lib, NOCARDS, 
NOPROG, MAP, EDIT, 
NODESUG. BATCH 


The machine language program output of a FORTRAN 
rv compilation i* in relocatable binary card format 
written on the system output tape, TSYSOUT, edited 
for punching, and/or on TSYSCR4 or the User's Pro¬ 
gram Tape, for subsequent loading and execution. 

source - the source of the FORTRAN IV language pro¬ 
gram. If omitted, TSYSIN is assumed. 

MAGTAPE - Indicates the source is the system 
input tape, TSYSIN. 

MAGTAPE, t - Indicates the source is symbolic 
tape ^in CODE mode (SYSOPS 3 
and 4 are not permissible). 

lib - Indicates that all called subroutines are to be in¬ 
cluded in the object program deck. 

DIB, tj.. - Indicates 1-7 symbolic tapes 

to be used as sources for the 
binary relocatable subroutines 
to be copied. 

NOCARDS - Indicates that the object program is not to 
be written on TSYSOUT edited for punching. 

NOPROG - Indicates that the object program is not to 

be written on TSYSCR4 or the User's Program Tape. 

map - Indicates that a storage map of the object pro¬ 
gram is to be written on TSYSOUT, edited for print¬ 
ing. 
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FORTRAN 


EDIT - Indicates that a listing of the object program is 
to be written on TSYSOUT, edited for printing. 
Selection of the EDIT option implies the selection of 
the MAP option, also. 

.NODEBUG - Indicates that generation of information for 
the traceback routine is to be inhibited. 

BATCH - Indicates that multiple compilations are to be 
performed, the end of which is signaled by the oc¬ 
currence of a COMPLETE card immediately following 
the END statement of the last program in the batch. 
Each compilation in the batch is controlled by the para¬ 
meters in the FORTRAN call and behaves as any non¬ 
batch compilation except that library routines are 
copied, if the lib parameter was specified, at the com¬ 
pletion of the batch rather than at completion of each 
compilation. Only one copy of each called subroutine 
is included regardless of the number of compilations 
calling the subroutine. 

ACTION Execution of the FORTRAN control instruction causes 

the following action: 

e The FORTRAN IV language program is compiled 
and machine language output, a source program 
listing, an object program edit and storage map, 
and cards edited for punching are produced, ac¬ 
cording to the options selected. 

• The machine language output is produced on the 
System's or User's Program Tape and the tape is 
left positioned immediately following the program 
produced, unless the NOPROG option was selected 
or compilation errors detected. If compilation 
errors were detected, the compiler restores the 
tape to its position at the start of the compilation. 

• The source listing, error comments, object pro¬ 
gram edit, and storage map are produced on the 
system output tape, TSYSOUT, edited for off-line 
printing in Data Select 0. 

• The object program cards are produced on the sys¬ 
tem output tape , TSYSOUT, edited for off-line 
punching in Data Select 1, unless the NOCARDS 
option was selected or compilation errors detected. 
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FORTIIAN 


Because some errors are not detected until the 
last phase of the compilation, the edited cards may 
be produced even though compilation errors exist. 
In no case will library routines be included (copied) 
if errors were detected in the source program. 


If a FORTRAN IV compilation is successfully com¬ 
pleted, the compiler returns control to the system 
via SYS.INXTCON, where the next control instruc¬ 
tion is executed; otherwise it returns via SYS, 1 
COMPER where the remaining control instructions 
in the JOB are investigated. If the control instruc¬ 
tion is one of the following, it is executed; otherwise 
a search for the next JOB is initiated. This process 
continues until a JOB instruction is encountered. 


ALTfiG 
ALT/^C 3X 
IE IT 
LOCTiiCL 
NOPRIKT 
OPAL 


COBOL 

CLOCK 

FORTRAN 

HLT 

JOB 


RELEASE 

REM 

REPORT 

REWIND 

PP.IPT 


REWINDLO 

SYSOPS 

TAG 

TAPES 


REMARKS 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 


1. A serious source program error detected in a 
batch compilation affects only the output of the 
compilation of that program containing the error 
except that the lib option, if selected, is ignored 
for the entire batch. At the completion of a batch 
compilation containing at least one serious source 
program error, the compiler returns control to 
SYS.ICOMPER. See ACTION, above. 

2, If the operator terminates the JOB because a 
serious tape error occurred during compilation, 
the Program Tape is restored to its position at 
the start of the compilation. 

Explanatio n 

Start of each compilation, where id is 
the program identity. 

Compilation is complete without serious 
errors. 

nnnn is the number of cards produced 
on TSYSOUT. 


Message 
ID IS id 

END COMP 

nnnnCRDS 
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FORTRAN 


CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 


Message 


Explanation 


ID IS First non-blank card did not con- 

NO IDENTITY tain program ID. Compilation 
coHvinvi©s in noymsti rrsstin,€5y* 


CMPERRS Compilation is complete. At least 

one source program error was 
detected. 


F4DUMP Machine or compiler error. Com 

puter halts. Press ADVANCE to 
wrap up compilation. 


^ TAPE POSIT. ERR. Machine or compiler error 

during the compiler segment 
identified by id. Computer 
halts. Press ADVANCE to 
wrap up compilation. 
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SECTION VIII 


LOADING FUNCTIONS 


The loading and initiating of program runs is the function 
of this group of control instructions. 

RPL and ABS programs are loaded in a forward sequence 
from the starting location of the program near the begin¬ 
ning of memory extending toward the end of memory. 

R£L programs are also loaded in a forward sequence, but 
normally into the end of memory, so that the last word of 
the program is loaded into the last word of memory. Com¬ 
mon storage for R£L programs normally begins (as arbi¬ 
trarily assigned by 32KSYS) at location lOOOg and may ex¬ 
tend to any length required within the space available. 

ON£ WORD 
S£ARCH 

For example, a program with the identity: 

PROGAAAlDATAA^l 

appears in RPL format on T4 and has a unique first word 
of identity. The program may then be loaded by the con¬ 
trol instruction: 

L Location Command Address and Remarks 

RPL T4, PROGAA^il$ 

The same control instruction without the dollar sign 

L Location Command Address and Remarks 

RPL T4,PROGAA^ll 

results in a transfer of control to lXCON£R. The omis¬ 
sion of a break character indicates that the second word 
of the ID is all spaces and no match can occur. 


A one-word-identity search may be used to locate a pro¬ 
gram with an identity of more than eight characters. If 
this method is used, the first word must be terminated by 
a break character because trailing spaces are significant. 
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GO 


uu i:.xecuies i"rogram(sj 


FUNCTION 


FORMAT 


PARAMETERS ^(OPTIONAL) - The symbolic tape containing binary sub¬ 

routines. 

ACTION • If any programs were compiled onto TSYSCR4 within 

the current JOB, TSYSCR4 is rewound and all pro¬ 
grams on TSYSCR4 are loaded. 

• If programs loaded (by previous JLOAD instruction or 
from TSYSCR4) are relocatable then: 

1. Any subroutines required are loaded from U 

if t \iias ifi^H , If t was not soecified. 

then TSYSLIB is searched. 

2. The NAME/SYMBOL list is written on the sys¬ 
tem output tape, TSYSOUT, edited for printing. 

Control is transferred to the program's starting address. 

EXAMPLE ONE • The following illustrates an RPL compilation with 

immediate execution: 

L Location Command Address and Remarks 

JOB EXAMPLE 1 

RPL TAC 

(TAC lan¬ 
guage deck) 

GO 


Executes programs, loading any programs from TSYSCR4 
that were compiled within the current JOB. 


L Location Command Address and Remarks 
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GO 


EXAMPLE TWO • The following illustrates multiple relocatable com¬ 

pilations with immediate execution; 

L Location Command Address and Remarks 


JOB EXAMPLE 2 

ALTAC 

(ALTAC 

language 

deck) 

TAG 

(TAG lan¬ 
guage deck) 

ALTAC 

(ALTAC 

language 

deck) 

GO 


EXAMPLE THREE • The following illustrates multiple relocatable com¬ 
pilations including the loading of previously compiled 
program decks, with immediate execution: 


L Location Command Address and Remarks 


JOB EXAMPLE 3 

ALTAC 

(ALTAC 

language 

deck) 

TAC 

(TAG lan¬ 
guage deck) 

ALTAC 

(ALTAC 

language 

deck) 

LOAD 
(binary re¬ 
locatable 
deck) 

GO 





GO 


EXAMPLE FOUR • The following illustrates multiple relocatable com¬ 

pilations including the loading and correcting of 
previously compiled decks, with immediate execu¬ 
tion; 

L Location Command Address and Remarks 

JOB EXAMPLE 4 

ALTAC 

(ALTAC 

language 

deck) 

TAG 

(TAG lan¬ 
guage deck) 

ALTAC 

(ALTAC 

language 

deck) 

LOAD 
(binary re¬ 
locatable 
deck) 

2 25P ALPHA SAMPLE 01 

LOAD 
(binary re¬ 
locatable 
deck) 

GO 



LOAD 


FUNCTION 

FORMAT 

PARAMETERS 

ACTION 

REMARKS 

EXAMPLES 


LOAD - Loads Binary Program Deck(s) 


Loads binary relocatable or absolute program deck(s) 
immediately following the LOAD control instruction, up 
to the next 32KSYS control instruction, for subsequent 
execution by a GO control instruction. 


L 

Location 

Command 

Address and Remarks 



LOAD 

L ■ - ■ .. ■ - — 


NONE 


If any programs were compiled onto TSYSCR4 within the 
current JOB, TSYSCR4 is rewound. All program decks 
immediately following the LOAD control instruction are 
loaded until a 32KSYS control instruction is encountered. 

The LOAD instruction must be used in conjunction with 
the GO instruction when loading relocatable decks because 
binary subroutines are not loaded and the edited NAME/ 
SYMBOL list is not written on TSYSOUT until a GO is en¬ 
countered. 

See GO (Examples 3 and 4.) 
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ABS 


ABS - ABS Loader Call 


FUNCTION 

FORMAT 


REMARKS 


Locates and loads an ABS program 


L 

Location 

Command 

Address and Remarks 



ABS 

t, jd. £0, j_ 


The parameters and action are the same as those for the 

RPL control instruction except for the following: 

1. The program designated by id is presumed to be in 
ABS format. 

2. An asterisk, TSYSIN, or an 8 may be used as the 
first parameter in the ABS control instruction, if a 
binary absolute deck of the program to be loaded 
follows the control instruction. Input must be via 
magnetic tape in IMAGE MODE. 


EXAMPLE 


Location Command Address and Remarks 


ABS 


,GO 


Explanation: Execution of this instruction causes the 
deck of binary cards which follows the instruction on 
TSYSIN to be loaded into memory. After the program 
is loaded, control is transferred to the program's start¬ 
ing address. The absence of the second parameter is 
indicated by a comma. 
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REL 


REL - REL Loader Call 


FUNCTION 

FORMAT 


PARAMETERS 


Locates and loads a REL program. 


L 

Location 

Command 

Address and Remarks 


m 

REL 

t]^, id, go, list, subs. 




t2 • • . . tjj 






m (OPTIONAL) - The loading address of the program. 

- The symbolic tape containing the REL program to be 
loaded. TSYSIN is excluded if input is in code mode. 

An asterisk (♦) is equivalent to TSYSIN. 

id - The program identity. K omitted, the first REL pro¬ 
gram found will be loaded. 

The id parameter may be omitted if t^ is an asterisk 
(*), TSYSIN or 8. ~ 

> 

go (OPTIONAL) - Indicates immediate or delayed running 
of a program. If GO is written, control will be trans¬ 
ferred to the program's starting address immediately 
following successful completion of the loading process. 
If the parameter is omitted, 32KSYS will save the 
starting address and will execute the next control in¬ 
struction. A subsequent 32KSYS "JMP*" control in¬ 
struction may be used to transfer control to the pro¬ 
gram's starting address (refer to JMP, Special Func¬ 
tions) . 

list (OPTIONAL) - This parameter, written as LIST, in¬ 
dicates that all program SYMBOUTS and REFOUTS 
which have been placed in the NAME/SYMBOL list up 
to and including this loading are to be edited for print¬ 
ing and written on TSYSOUT immediately, before 
transferring control to the program ("GO" or "JMP"). 
If the specified program is not loaded successfully, 
the NAME/SYMBOL list, if any, will be processed as 
above, regardless of whether or not LIST was speci¬ 
fied. 
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REL 


subs (OPTIONAL) - This parameter, written as SUBS, 
indicates that the library tape(s) will be searched 
for required subroutines to be loaded if there are 
any undefined symbols remaining at the completion 
of the loading process. 

SUBS^ t 2 ^.. tn - 1-7 symbolic tapes which designate 

the libraries containing binary subroutines that may 
be used by the program just loaded. 

Tapes are searched in the o rde r lis ted in the parame¬ 
ters. 

ACTION The action is the same as that for the RPL control instruc¬ 

tion except for the following; 

• The program W is presumed to be REL format. 

• If undefined symbols still exist following loading of 
the designated subroutines from the library tape(s) 
and GO is specified, the NAME/SYMBOL list will be 
edited and placed on TSYSOUT for printing. Control 
will then be transferred to IXCONER. 

Note; Binary library tapes must contain a sentinel 
block of W/ZZZZZZZZ following the last 
subroutine. 

• If there are undefined symbols, the SUBS parameter 
is not specified, and GO is specified, the same 
error procedure as above will occur. 

• If a symbol is defined m.ore than once, it will not be 
considered an error unless the symbol is referenced, 

• The unique symbol LOADSETS. AVAILMEM has a 
special definition. If it appears first as a referenced 
symbol, it is immediately defined as being the loca¬ 
tion one less than the origin of the program just loaded. 
This origin is then reduced by one to preserve the lo¬ 
cation. If this symbol appears first as a defined sym¬ 
bol, that definition is given to it. (Refer to special 
function PORIG.) 

• If location LOADSETS. AVAILMEM appears on the 
NAME/SYMBOL list, its left and right address por¬ 
tions, respectively, will contain, after loading, the 
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REL 


REMARKS 


EXAMPLE ONE 


sum of Common origin and the size of Common, and 
the address of the smallest program origin greater 
than zero. (Refer to SEGMENT and MASTER, Seg¬ 
mentation. ) 

• If the LIST parameter is specified, the NAME/ 

SYMBOL list will be edited and placed on TSYSOUT 
for off-line printing. 

1. Before control is given to the loaded REL program(s) 
the NAME/SYMBOL list is cleared. 

2. REL programs are loaded in a forward sequence, nor¬ 
mally into the end of memory or contiguous with the 
last REL program loaded. However, if a loading ad¬ 
dress is specified, the REL program is loaded forwar 
beginning at m. 

3. m must be greater than lOOOlg. 

4. If the source of a REL program is specified as 
TSYSIN or ♦, the program must immediately follow 
the REL control instruction and must be in image 
mode. 

This example illustrates the loading of a single REL pro¬ 
gram. 


L Location Command 


Address and Remarks 


REL 4,TRAJ,GO,LIST,SUBS, 

LIBC, LIBA 


Explanation: Execution of this instruction causes the REL 
program TRAJ, to be loaded into the end of memory from 
the tape assigned to the system program unit number 4. 

Subroutires required to satisfy undefired program 
symbols are to be loaded first from I.IEC, then 
LIRA. TSYSLIB will not be searched, since it was 
not specified. 



REL 


EXAMPLE TWO This example illustrates the joint loading of two REL pro¬ 

grams. 

L Location Command Address and Remar ks 

REL 4,DIFF1$ 

REL 4,DIFF2,GO,LIST, 

SUBS 

Explanation: Execution of these instructions causes the 
REL program, DIFFl to be loaded from the tape assigned 
to the system program unit 4, into the end of memory and 
a second REL program, DIFF2, to be loaded into memory 
adjoining DIFFl. Subroutines required by either program 
to satisfy undefined symbols are to be loaded from 
TSYSLIB, When both programs and all subroutines are 
loaded, the NAME/SYMBOL list is edited and placed on 
TSYSOUT for off-line printing. Control is then trans¬ 
ferred to the starting address of DIFF2. 

Note: For making corrections to relocatable binary 

programs, refer to REMARK 2 of OCT, De¬ 
bugging Functions. 

EXAMPLE THREE L Location Command Address and Remarks 

REL TSYSCR4, JOE, ,, SUBS 

PORIG JOE 

245 P ALPHA PROGRAMA 

JMP * 


Explanation: Execution of these instructions causes pro¬ 
gram JOE to be loaded from the tape assigned to 
TSYSCR4 with subroutines. However, since the ALPHA 
correction is to be made to JOE and the P-counter is set 
to the last program loaded (a subroutine) the command 
PORIG (Special Functions) must be given before the 
ALPHA command. 
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RPL 


RPL - RPL Loader Call 


FUNCTION 

FORMAT 


PARAMETERS 


ACTION 


REMARKS 


Locataa and loads an RPL program. 


L 

Location 

Command 

Address and Remarks 



RPL 

t. W, go, £ 


The symbolic tape containing the RPL program to be 
loaded. 

id - The program identity. If omitted, the first RPL 
found will be loaded. 

|[o (OPTIONAL) - Indicates immediate or delayed running 
of program. If GO is written, control is to be trans¬ 
ferred to the program's starting address immediately 
following successful completion of the loading process. 
If the parameter is omitted, 32KSYS saves the start¬ 
ing address and executes the next control instruction. 

A subsequent 32KSYS "JMP" instruction may be used 
fj^snsfer control to the program's starting address. 
(Refer to JMP, Special Functions.) 

i_(OPTIONAL) - An octal number to be added to the normal 
loading addresses of the program being loaded. 

e ^is searched forward for program W until W is found 
either as an RPL identifier, or as one of the ID's in¬ 
cluded in an index block, or, until a sentinel block of 
Z's is found. If W is found in an index block, or the 
sentinel block is encountered, the tape is searched 
backward. If ^ is still not found, control will be 
transferred to IXCONER. 

e When the designated program is located, it is loaded 
into memory. 

e If GO is not specified, control will be transferred to 
INXTCON. 

e If GO is specified, control will be transferred to the 
program's starting address. 

1. If ^is specified as TSYSIN, exit will be made to 
IXCONER. 
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RPL 


modification by ^is less than iOOOOg, exit will be 
made to IXCONER. 

EXAMPLE ONE This example illustrates the use of an RPL call with the 

program to be executed immediately. 


L Location Command Address and Remarks 


RPL T4,SOLOMON23,GO 


Explanation: Execution of this instruction causes RPL 
program SOLOMON23 to be loaded from tape T4 and con¬ 
trol to be transferred immediately to its starting address. 

EXAMPLE TWO This example illustrates the use of an RPL call with de¬ 

layed execution of the program. 


L Location Command Address and Remarks 


R.PL 4,SOLOMON23 

. (Other SYS control 

instructions) 

JMP * 

Explanation: Execution of these instructions causes RPL 
program SOLOMON23 to be loaded from the tape assigned 
to the system program unit number 4. When the 32KSYS 
"JMP *" control instruction is encountered, control will 
be transferred to the program's starting address. 
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SECTION IX 


SEGMENTATION FUNCTIONS 


SEGMENTATION 

PROCESS 


LOADING 

SEGMENTED 

PROGRAMS 


Two 32KSYS control instructions, SEGMENT and MASTEF 
provide the facilities for dividing a relocatable binary pro 
gram, too large to be run with available memory, into 
smaller segments. Each of these segments may then be 
contained individually in the memory area. 

The segmentation process generates segments by writing 
one or more program components (which are loaded as a 
single unit into memory) onto magnetic tape in RPL forma 

The segmentation process takes place in three phases: 
first, the compilation of components as individual smaller 
progranris in REL format; second, the generation of seg¬ 
ments in RPL format; and third, the loading and running 
of the segmented program in RPL format. The 32KSYS 
control instructions SEGMENT and MASTER are used in 
the second phase. 

When segments are used in a running program, they may 
be independent of one another, or they may contain cross- 
references, If they are independent, they may be gener¬ 
ated one at a time during the second phase of the segmen¬ 
tation process. If any contain cross-references, the ref¬ 
erencing must be done either via the Common area of 
memory or via a Master segment which is contained in 
memory during the generation of all segments. 

The SEGMENT instruction generates segments by writing 
the components just loaded onto magnetic tape. The 
MASTER control instruction is used to indicate that the 
component{s) just loaded are to form a Master segment, 
and are to remain in memory during the generation of 
succeeding segments. 

Program segments may be loaded by the 32KSYS Internal 
loader, which may be called by either of the following 
methods: 
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Via the 32KSYS Generator LOADGEN (Library Rou¬ 
tines), which will create the necessary TAG language 
coding. 

Via the 32KSYS entry 1 INTLD {32KSYS Entries), 
which provides a transfer of control to the internal 
loader during the running of the program. 



SEGMENT 


SEGMENT - Defines a Program Segment 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


Cause! program components loaded into memory in REL 
format to be written as a segment onto magnetic tape in 
RPL format. 


L 

Location 

Command 

Address and Remarks 



SEGMENT 

t, id, master 


The symbolic tape onto which the segment is to be 
written. If TSYSTEM or TSYSOUT is designated, 
exit will be made to IXCONER. 

^ - 16 or fewer alphanumeric characters which will be the 
identity of this particular segment. Spaces are sig¬ 
nificant. 

master (OPTIONAL) - A parameter written as MASTER 
which enables a Master segment to be written on tape. 

Execution of a SEGMENT control instruction initiates the 

following actions: 

e Examines the NAME/SYMBOL list associated with the 
particular segment of the program to determine if 
there are any undefined symbols. Undefined symbols 
cause exit to IXCONER. 

e Writes the portion of memory between the most re¬ 
cent program origin (set by REL loader) and the be¬ 
ginning of the Master Segment, if a Master segment 
has been defined, onto _^in RPL format. If a Master 
segment has not been defined, that portion of memory 
between the most recent program (set by REL loader) 
and the end of memory will be written onto t. 

e Writes a sentinel block of Z's onto t^following the seg¬ 
ment, and positions the tape at the beginning of this 
block. If another segment is to follow, it will be writ¬ 
ten over the sentinel block and a new sentinel block 
will be written following the new segment. This pro¬ 
cedure is repeated for all segments, including the 
Master segment, thus insuring the presence of a 
sentinel block after the final segment only. 
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SEGMENT 


Page revised 4-li;~65 


REMARKS 

EXAMPLE 


• Clears to fixed-point zeros that portion of memory 
occupied by the segment after the segment is written 
onto t. 

• Clears the NAME/SYMBOL list of all names and 
symbols defined by the particular segment, excluding 
the Master segment list, if used. 

• Writes onto t ir FPL formst that area between the 
beginning of one Master segment and the beginning 
cf the next (or the end of memory, if only one 

msster segment is in memory), if the master parameter 
is used. In addition, it clears the memory area and 
tlie name/symbol list used by tnat Master Segment. 

Symbolic Location LOADSETS. AVAILMEM may be defined 
in every segment if it is not defined in 'amy associated Master 
segment. 

ONE This example illustrates the use of SEGMENT without a 

master parameter. Assume that the first segment (SEG 1) 
of a large program consists of components PROG 1 and 
PROG 2, and that these components are in REL format on 
the tape assigned to system program unit number 4. 


L Location Command Address and Remarks 


REWIND 

REL 

REL 

SEGMENT 


6 

4, PROG 1 

4, PROG 2, , LIST, SUBS 
6, SEG 1 


Explanation: Execution of these instructions causes the 
two components to be loaded and written in RPL format 
onto the tape assigned to system program unit number 6. 
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SEGMENT 


EXAMPLE TWO This example illustrates the use of SEGMENT with the 

master parameter. Assume that EXEC, SUBEXECl, 
and SUBEXEC2 are Master segments, APROG, BPROC, 
CPROG, and DPROG each constitute segments. 

L Location Command Address and Remarks 


REWIND 

6 

REL 

4, EXEC, , LIST, SUBS 

MASTER 


REL 

4, SUBEXECl, , LIST, SUBS 

MASTER 


REL 

4, APROG, , LIST, SUBS 

SEGMENT 

6, SEGIA 

REL 

4, BPROG, , LIST, SUBS 

SEGMENT 

6, SEGIB 

SEGMENT 

6, SEGl, MASTER 

REL 

4, SUBEXEC2, , LIST, SUBS 

MASTER 


REL 

4, CPROG, , LIST, SUBS 

SEGMENT 

6, SEG2A 

REL 

4, DPROG, , LIST, SUBS 

SEGMENT 

6, SEG2B 

SEGMENT 

6, SEG2, MASTER 

SEGMENT 

6, EXEC, MASTER 


Explanation: Execution of these instructions causes the 
six segments to be written in RPL format onto the tape 
assigned to system program unit number 6, The RPL 
6, EXEC, GO causes the overall program to be run. 
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MASTER 

FUNCTION 


FORMAT 

PARAMETERS 

ACTION 

REMARKS 


EXAMPLE 


•65 


MASTER - Defines a Master Segment 


Indicates to 32KSY5 that (1 } a segmenting process using 
a Master segment is about to take place, and (i) a Master 
segment consisting of one or more REL components has 
been loaded and is to remain in memory during the forth¬ 
coming loading and writing of the various segments. The 
Master segment remains in memory during segmentation 
so that symbolic cros s - r eie rences may be made with 
succeeding segments associated with it. 


L 

Location 

Command 

Add. ess and Remarks 



MASTER 



None 


Stores the Master segment's starting address in a list. 
This address is taken from the last relocatable END card 
of a Master component to be loaded that contains a start¬ 
ing address. If no component contains a starting address, 
zero will be stored. 

1. If a MASTER control instruction is given, control 
may be transferred to a Master segment still in 
memory by the use of a "IMP*" control instruction, 
if the Master segment has not been written. 

2. Each additional MASTER control instruction forces 
information about the preceding Master segment 

to be stored in a push-down list in memory. This 
information is restored when the succeeding Master 
segment is written out. 

3. Refer to REMARKS of SEGMENT. 

Assume that the Master segment consists of two compo¬ 
nents in relocatable binary format with ID's of EXECl 
and EXEC2, both contained on the tape assigned to sys¬ 
tem program unit number 4. 

L Location Co mmand Address and Remarks 

JOB 
REL 
REL 
MASTER 


XRAY 
4, EXECl 

4, EXEC2, , LIST, SUBS 
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MASTER 


Explanation: Exacution of thaaa initructiona cauata the 
two componenta to be loaded into memory» forming a 
Maater aegment and retaining the aegment in memory 
until all other aegmenta are loaded and written onto tape. 
The atarting addreaa of the Maater aegment ia one of the 
following: 

e The atarting addreaa of EXEC1« if EXEC2 haa no 
atarting addreaa. 

e The atarting addreaa of EXEC2, if it containa a 

atarting addreaa. EXEC2 takea precedence becauae 
it ia the laat to be loaded. 

m Zeroa, if neither EXECl nor EXEC2 contain a atart> 
ing addreaa. 

Note: TAG library aubroutinea never contain 

atarting addreaaea. 
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SECTION X 


TAPE HANDLING FUNCTIONS 


This group of control instructions is con¬ 
cerned specifically with magnetic tape oper¬ 
ations. These operations include rewinding 
tapes, reading tapes forward and backward, 
writing on tapes, locating on tapes, writing 
sentinels, and locating sentinels. 32KSYS 
XORD is used for all tape movements by 
these control instructions. 



REWIND 


REWIND ~ Rewinds Magnetic Tape 


FUNCTION 

FORMAT 


PARAMETERS 

ACTION 


Rewinds magnetic tapes. 


L 

Location 

Command 

Address and Remarks 



REWIND 

t. ... , ^ 


t - The symbolic tape to be rewound, 
t.t are rewound. 
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FUNCTION 

FORMAT 

PARAMETERS 

REMARKS 

ACTION 


.-15-65 


REWINDLO 


REWINDLO - Rewinds Magnetic Tape with Lockout 

Rewinds magnetic tapes with lockout. 


L 

Location 

Command 

Address and Remarks 



REWINDLO 

^ • y ^ 


t - The symbolic tape to be rewound with lockout. 


Operators are instructed that any tape rewound with 
lockout is subject to removal. 


• Program unit numbers and ell names associated with 

t, .,t are released from their specific assignments 

by removing the names from the tape name list. 
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READF 


READF - Reads Magnetic Tape Forward 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


EXAMPLE ONE 


EXAMPLE TWO 


Spaces forward and/or reads blocks forward from a 
specified magnetic tape into memory. 


L 

Location 

Command 

Address and Remarks 



READF 

t, nbs, nbp, addr 


t - The symbolic tape to be spaced and/or read for¬ 
ward. 

nbs (OPTIONAL) - The number (decimal) of blocks to be 
spaced forward. If nbp below is omitted, nbs must 
be specified. 

nbp (OPTIONAL) - The number (decimal) of blocks to 
be read forward. If nbs is omitted nbp must be 
specified. 

addr (OPTIONAL) - The address into which the data 
on the tape is to be read. If nbp is omitted or is 
zero, addr may be omitted. 

t is spaced forward nbs number of blocks, and nbp 
number of blocks are read into memory beginning at 
addr . 

This example illustrates the use of a space-read 
command. 

L Location Command Address and Remarks 

READF 6, 2, 5, 15000 

Explanation: Execution of this instruction causes the 
tape assigned to system program unit number 6 to be 
spaced forward two blocks, and the next five blocks 
to be read into memory starting at location 15000g. 

This example illustrates the use of a read-only 
command . 




REAOF 


L Location Command Address and Remarks 


READF T-024, , 36, 25000 

Explanation: Execution of this instruction causes 36 
blocks of T-024 to be read into memory starting at 
location 25000g . No spacing of blocks is to take 
place prior to the read. 

EXAMPLE THREE This example illustrates the use of a space-only 

command. 

L Location Command Address and Remarks 


READF T-023, 160 

Explanation: Execution of this instruction causes T-023 
to be spaced forward 160 blocks. No reading is to take 
place. 
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READB 


READB - Reads Magnetic Tape Backward 


FUNCTION 

FORMAT 


REMARKS 


EXAMPLE 


Space backward and/or reads blocks backward from a 
specified magnetic tape into memory. 


L 

Location 

Command 

Address and Remarks 



READB 

t; nbs, nbp, addr 


The parameters, action, and remarks concerning READB 
are the same as those for the READF instruction except 
that spacing and/or reading is performed backward on 
the tape. 

L Location Command Address and Remarks 


READB TSYSCRO, 5, 10, 3Z000 

Explanation: Execution of this instruction causes 
TSYSCRO to be spaced backward 5 blocks, and the 
nsxt iO blocks to bs read bsckward into mernory start- 
ing at location 32000g . 
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WRITE 


WRITE - Writes on Magnetic Tape 


FUNCTION 


FORMAT 


PARAMETERS 


REMARKS 


EXAMPLE 


Spaces forward and/or writes a specified number of 
blocks from memory onto an output magnetic tape. 


L 

Location 

Command 

Address and Remarks 



WRITE 

t, nbs, nbp> addr 


^ - The symbolic tape to be spaced forward and/or 
written, upon. 

r?bs (OPTIONAL) - The number (decimal) of blocks to 
be spaced forward. If nbp below is omitted nbs 
must be specified. 

nbp (OPTIONAL) - The number (decimal) of blocks to be 
written. If nbs is omitted, nbp must be specified. 

^tidr (OPTIONAL) - The address from which data is to 
be written. If ^bp is omitted or is zero, addr may 
be omitted. 

The remarks and action for the WRiTE control instruc¬ 
tion are the same as those for the READF instruction 
except that writing onto tape rather than reading from 
tape is performed. 

^ Location Command Address and Remarks 

WRITE 3. 3, 6 , 17500 

Explanation: Execution of this instruction causes the 
tape assigned to system program unit number 3 to be 
spaced forward three blocks, and the next six blocks 
to be written starting from location 175000 . 
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LOCSENT 


FUNCTION 


FORMAT 


PARAMETERS 


action 


EXAMPLE 


LOCSENT - Locates a Sentinel on Magnetic Tape 


Searches forward on a tape for a 
contains a designated sentinel as 
words, 


sentinel block which 
each of the first 120 


L 

Location 

Command 

Address and Remarks 

_ 


LOCSENT 

t, sent 

______—- 


t - The symbolic tape to be searched. 

sent (OPTIONAL) - The sentinel word. If omitted, 
Z's are assumed. 

• t IS searched forward for a sentinel block with 
"sent as each of its first 120 words. 


When the designated sentinel block is found, t is 
positioned immediately past the sentinel block. 

If the sentinel is not found, the computer will 
encounter a serious tape error. 

L Location Command Address and Remarks 


LOCSENT 6, ZZZZZZZZ 

Explanation; Execution of this instruction causes the 
tape assigned to program unit num.ber 6 to be searched 
forward for a sentinel block which contains all Z's 
in the first 120 words. After the sentinel block is 
located, the tape is positioned immediately past the 
block. 
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LOCABS, LOCRPL, 
LOCTACL,LOCREL 


LOCABS, LOCRPL, LOCTACL, LOCREL - Locates 
a Program on Magnetic Tape 

FUNCTION Searches a tape for specified TAG language, RPL, 

ABS or REL programs. 


FORMAT 


PARAMETERS ^ - The symbolic tape to be searched. 

id - The program to be located. 

sent (OPTIONAL) - The sentinel word. If omitted, 

Z's are assumed. 

ACTION e ^is searched forward for program W until either 

id is located or a sentinel block of sent is en¬ 
countered. If the sentinel block is encountered 
prior to the the tape will be searched back¬ 
ward. If the ^ is still not found, exit will be 
made to IXCONER. (If LOCRPL, refer also to 
RPL, Loading Functions). 

e After the designated program is located, the tape 
is positioned immediately prior to the first block 
of the program. 

EXAMPLE ONE Assume that Tape T-024 contains the following TACL 

programs: 

PART 1 

PART 2 040162 
PART 3 041062 

JL Location Command Address and Remarks 

LOCTACL T-024. PART 3 041062 

LOCTACL T-024, PART 3$ 



10-9 



LOCABS, LOCRPL, 
LOCTACL, LOCREL 


iiiXAMPLE TWO 


Explanation: Execution of either of these instructions 

causes the third program on the tape to be located. 


Assume that Tape ALPHA contains the following RPL 
programs: 

PART 1 

PART 2 040162 
PART 3 041062 

L Location Command Address and Remarks 


LOCRPL ALPHA, PART 3 041062 
LOCRPL ALPHA, PART 3$ 


Explanation: Execution of either of these instructions 
causes the third program on the tape to be located. 



WRTABS 


FUNCTION 


PARAMETERS 


WRTABS - Writes on Magnetic Tape in ABS Format 


Writes words between designated memory locations 
onto magnetic tape in absolute binary card (ABS) for¬ 
mat and assigns a program identity to the data written 
as the new ABS program. 


L 

Location 

Command 

Address and Remarks 

z 


WRTABS 

t, id, addri , addr2 , 

"addr ^ , ^ 


£ (OPTIONAL) - The character Z- which indicates that 
every word (including fixed point zeros) in the pro¬ 
gram will be written onto t. If omitted, leading 
words of zeros will be omitted from each absolute 
binary card produced. If trailing words of zeros are 
present, they will be included to complete a card. 

^ - The symbolic tape on which the data in ABS card 
format is to be written. 

id - The identity of the new ABS program. The first 
four characters of id are used to provide an ID in 
Hollerith code for Columns 1-4 of the ABS card 
output. 

^ddr I (OPTIONAL) - The first address from which 
information is to be written on tape. If omitted, 
addr ^ will be program origin (set only by REL 
loader). 

^ddr 2 (OPTIONAL) - The last address from which 
information is to be written on tape. If omitted, 
addr ^ will be effective end of memory +1. 

*dtir j (OPTIONAL) - The starting address of the new 
ABS program. An asterisk (♦) indicates that the 
address stored in INTRYJA will be used. (INTRYJA 
normally contains the address of a location in the 
current object program to which control is to be 
transferred from 32KSYS). If omitted, addr . will 
be used. 
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WRTABS 


i (OPTIONAL) - An octal number to be added to addr j 
when the loading address of the new ABS program 
is formed. The number is also added to addr ^ 
to form the program starting address. The addi¬ 
tion of the values takes place modulo machine size. 

All information between addr ^ and addo will be 
written onto t in absolute binary card (ABS) format. 
If Z is written as the z parameter, words of zeros 
will also be included in the output. 

Two sentinel blocks of Z's are written on the out¬ 
put tape following the new ABS program. 

t is positioned immediately prior to the first block 
of Z's. 

The message: id ORIGIN addr j n CARDS will be 
written on TSYSOUT. 

ID is id n CARDS is typed if the ABS program is 
written on TSYSOUT. 

EXAMPLE ONE This example illustrates the use of WRTABS without an 

offset address. 

L Location Command Address and Remarks 


WRTABS T-024. JACKSON, 20000, 
30000$ 

Explanation: Execution of this instruction causes the 
contents of all memory locations from 20000g to 30000 g, 
except words of zeros, to be written in absolute binary 
format onto tape T-024. The program identity of the 
new ABS program is JACKSON. 

The address specified by addr 20000 g, is to be used 
as the starting address for the ABS program, as addr g 
is omitted. Two sentinel blocks of Z's are written 
following the new ABS program, and the tape is positioned 
immediately prior to the first block of Z's. 

EXAMPLE TWO This example illustrates the use of WRTABS with an 

offset address. 


ACTION • 
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WRTABS 


L Location Command Address and Remarks 

Z WRTABS ALPHA, ABLE, 20000 

25000,22000,600 

Explanation: Execution of this instruction causes the 

contents of all memory locations from 20000 g to 
25000 g including words of zeros, to be written in 
absolute binary format onto tape ALPHA. The program 
identity of the new ABS program is ABLE. The location 
into which ABLE is to be loaded is 20600g. The starting 
address of the new ABS program is to be 22600 g. Two 
sentinel blocks of Z's are written following the new ABS 
program, and the tape is positioned immediately prior 
to the first block of Z's, 

EXAMPLE THREE This example illustrates the use of WRTABS with 

TSYSOUT(5) as the output tape. 

L Location Command Address and Remarks 


Z WRTABS 5, GOODCHEER, 16000, 

22000 

Explanation; Execution of this instruction causes the 
contents of all memory locations from 16000 g, to 
22000 g, including words of zeros, to be written in 
absolute binary format onto TSYSOUT. The program 
identity of the new ABS program is GOOD CHEER. The 
address specified by addr i , 16000g,is to be used as 
the starting address for the ABS program, as addr -^ is 
omitted. WRTABS transfers binary card images to 
this tape for off-line punching in Data Select 1, Image 
Mode (20 words per card, six cards per block). 
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WRTRPL 


WRTRPL - Writes on Magnetic Tape in RPL Format 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


Writes words between designated memory locations 
onto magnetic tape in RPL format and assigns a 
program identity to the data written as a new RPL. 


L 

Location 

Command 

Address and Remarks 



WRTRPL 

t, id, addr 1 , addr , addr^,i 


^ - The symbolic tape excluding TSYSOUT, on which 
the RPL is to be written. 

id - The identity of the new RPL. 

addr ^ (OPTIONAL) - The first address from which 
information is to be written on tape. If omitted, 
addr i will be programmed origin (set only by 
REL loader). 

addr 2 (OPTIONAL) - An address from which information 
is to be written on tape. If omitted, addr ^ will be 
the effective end of memory + 1. 

addr ^ (OPTIONAL) - The starting address of the RPL 
program. An asterisk (’’‘) indicates that the address 
stored in INTRYJA will be used. (INTRYJA normal¬ 
ly contains the address of a location in the current 
object program to which control is to be transferred 
from 32KSYS). If omitted, addr ^ will be used. 

_i (OPTIONAL) - An octal number to be added to addr ^ 
when the loading address of the new RPL program 
is formed. The number is also added to addr , to 
form the program starting address. The addifion of 
the value takes place modulo machine size. 

• All information between memory locations addr^ 
and addr ^ will be written on ^ in RPL with a 
program identity of id. 

e Two sentinel blocks of Z's are written on Tape t. 
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WRTRPL 


• t is positioned imnnediately prior to the first block 
of Z's. 

• The message: RPL ORIGIN addr 

id RPL n BLOCKS 

will be written on TSYSOUT. 

EXAMPLE ONE This example illustrates the use of WRTRPL without 

an offset address, following a REL load, and using sym¬ 
bolic addresses for a^dr ^ and addr^ . 

L Location Command Address and Remarks 


2000 REL 4, DIFF 

WRTRPL ALPHA, GOODBYE, 
DIFF.START, 

DIFF. END 


EXAMPLE TWO 


Explanation; Execution of the REL instruction cause 
the REL program DIFF to be loaded into memory starting 
at location ZOOOOg from the tape assigned to system pro¬ 
gram unit 4. Execution of the WRTRPL instruction 
causes the contents of memory locations from DIFF. 


START to DIFF. END to be written in RPL format onto 
Tane ALPHA iiiit-Vi :ar, TCl nonriRvir rMinr c'T’ADT-' 

and DIFF, END are defined by the REL loader in the 
NAME/SYMBOL list if TAC SYMBOUT instructions at 
compile time, or a 32KSYS SYMDEF instruction at run 
time, permit recognition of the symbols. If the symbols 
are not defined, control will be transferred via 


IXCONER, DIFF. START will be used as the starting 
address for the RPL since addr ^ is omitted. Two 
sentinel blocks of Z s are written following the new 
RPL on Tape ALPHA then ALPHA is repositioned im¬ 
mediately prior to the first block of Z*8, 


This example illustrates the use of WRTRPL with an 
offset address. 


il Locatio n C^ommand Address and Remarks 

WRTRPL T-023, HELLO, 20000, 

25000,22000, 325$ 

Explanation: Execution of this instruction causes the 
contents of memory locations from ZOOOOg to 25000g 


1 A 1C 
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WRTRPL 


to be written in RPL format onto Tape T-023. The 
program identity of the new RPL is HELLO. The 
location into which HELLO is to be loaded is 20325 q. 

The starting address of the new RPL is to be 22325g . Two 
sentinel blocks of Z's will be written following the 
new RPL; then the tape will be positioned immediately 
prior to the first block of Z's. 
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WRTSENT 


FUNCTION 

FORMAT 

PARAMETERS 

ACTION 

EXAMPLE ONE 


EXAMPLE TWO 


WRTSENT " Writes a Sentinel on Tape 


Writes a sentinel block of 128 words of a designated 
configuration onto a specified magnetic tape. 


L 

Location 

Command 

Address and Remarks 



WRTSENT 

- 

t, sent 


^ - The symbolic tape to be written upon, 

sent - The sentinel word to be used as each of the 128 
words of the sentinel block, 

A sentinel block of 128 words of sent is written onto t, 
^remains positioned following the sentinel, ■ 

This example illustrates the use of a WRTSENT command 
with an eight-character sentinel. 

L Location Command Address and Remarks 


WRTSENT 6, ZZZZZZZZ 

Explanation: Execution of this instruction causes a 
sentinel block containing 128 words of Z's to be written 
onto the tape assigned to system program unit number 
6 , 


This example illustrates the use of a WRTSENT command 
with a sentinel of fewer than eight characters. 

L Location Command Address and Remarks 

WRTSENT NINE, XXX 

Explanation: Execution of this instruction causes a 
sentinel block containing 128 words of OOOOOXXX to be 
written onto symbolic tape NINE, 
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SECTION XI 

DEBUGGING FUNCTIONS 


Various control instructions within the Philco Operating 
System aid the programmer during the debugging of his 
program. DUMP and SNAP instructions provide two 
methods of obtaining information stored within various 
parts of memory via the High Speed printer. Three other 
instructions, OCT, CMD, (COMMAND), and ALPHA, per¬ 
mit replacement of a word in memory in octal, command, 
and alphanumeric representation, respectively. 

The post-mortem dumping of the DUMP control instruc¬ 
tion takes place in three stages. The first, or pre-dump 
stage, which takes place whenever a DUMP control in¬ 
struction is encountered by 32KSYS, stores information 
concerning the dump request within the dump table in 
memory. The second, or intermediate stage, copies bi¬ 
nary data from memory to TSYSDMP. The third, or con¬ 
version phase, edits the memory specified by the dump 
table in the specified format and transfers the edited in¬ 
formation to TSYSOUT. 

The latter two stages will take place only if a post-mortem 
dun^p is initiated. (Refer to IZERO, lERRDMP, and 
ISUBERR.) The dumping process for the SNAP control 
instruction differs from that of the DUMP instruction only 
in that the data from the location(s) to be snapped is trans¬ 
ferred to TSYSDMP during the running of the program. 

The unedited data on TSYSDMP is edited to TSYSOUT if 
control is transferred to IZERO, lERRDMP, ISUBERR, 
lENDJOB, INXTCON, IXCONER or Location 1 (operator 
action only)^. qj. during a CLOBDJ^P procedure, 
provided TWYSDJiP has not been rewound. 



DUMP 


DUMP - Dumps Memory 


FUNCTION 


FORMAT 


PARAMETERS 


REMARKS 


Specifies what information is to be edited for the High- 
Speed Printer in a post-mortem dump< 


L 

Location 

Command 

Address and Remarks 



DUMP 

format, addrj, addr2 


format - The format in which information within the speci¬ 
fied memory locations is to be dumped. 


A Alphanumeric Conversion 
C Command Conversion 
F Floating Point Conversion 
H Hexadecimal Conversion 
O Octal Conversion 
nS Fixed Point Conversion 

n (OPTIONAL) - A decimal number, 0 through 47, which 

~ indicates the position of the binary point. If n is 
omitted, 0 will be assumed. 

addrj - The starting address of the area to be dumped. 
(Refer to SYSOPS 8.) 

addr2 - The ending address of the area to be dumped. 
(Refer to SYSOPS 8.) 

1. If an illegal parameter is used, if any parameter is 
omitted, or if addr z is less than addr j, the DUMP 
card is ignored. 

2. A post-mortem dump occurs whenever control is 
transferred to lERRDMP, ISUBERR, or IZERO. 

3. DUMP control instructions should normally appear 
prior to the instruction which initiates the running 
of a program. Information specified by the parame¬ 
ters is saved by 32KSYS until a new JOB instruction 
is encountered. 

4. A maximum of ten DUMP instructions may be speci¬ 
fied. Any DUMP instruction in excess of ten will be 
ignored. 
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DUMP 


5. Semi-colons or commas may be used interchangeably 
as break characters in the DUMP card. 

6. DUMP cards containing errors are ignored and an 
appropriate error message is written on TSYSOUT. 


EXAMPLE ONE 


Location Command Address and Remarks 


DUMP 


O. 11000, 17000 


Explanation: Execution of this instruction causes the dump 
routine to be preset to execute a dump from location llOOOg 
through 17000g in octal format. 


EXAMPLE TWO 


L Location Command Address and Remarks 


DUMP A, NAME.FLAD+33, 

1400P 


Explanation: Execution of this instruction causes the dump 
routine to be preset to execute a dump, from location 
NAME.FLAD+33 through the location represented by the 
sum of HOOg and the origin of the last REL program loaded, 
in alphanumeric format. This instruction must immediate¬ 
ly follow the loading of the REL program which contains 
NAME.FLAD. NAME.FLAD is defined by the REL loader 
in the NAME/SYMBOL list U a TAG SYMBOUT instruc¬ 
tion at compile time, or a 32KSYS SYMDEF instruction at 
run time, permits recognition of the symbol. 
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SNAP 


SNAP - Snaps Memory 


FUNCTION 


FORMAT 


PARAMETERS 


Specifies what information is to be edited for the High- 
Speed Printer when designated conditions occur during 
the running of a program. 


L 

Location 

Command 

Address and Remarks 

£ 

loc 

SNAP 

format;addr i;addr 2 : 
addr 3 ;cond 


The parameters in the Address and Remarks field are 
separated by semi-colons. 

p - L or R, which indicates whether the left or right in¬ 
struction of a particular location will initiate the 
snap routine. The snap occurs prior to the execu 
tion of the instruction. If p is omitted L will be as ¬ 
sumed. 


loc - The location containing the instruction that will 
initiate the snap routine. 


format - The format in which information within the 
specified memory locations is to be dumped. 


A 

C 

F 

H 

O 

nS 


Alphanumeric Conversion 
Command Conversion 
Floating-point Conversion 
Hexadecimal Conversion 
Octal Conversion 
Fixed-point Conversion 


II (OPTIONAL) - A decimal number, 0 through 47, which 
indicates the position of the binary point. If n is 
omitted, 0 will be assumed. 


iddr^ - the locetion of the 
first word to be 
dumped. 

iddr 2 _ the location of the 
last word to be 
dumped. 


addr 3 (OPTIONAL) - The address of the last word in a six- 
word dump table. If no address is specified, the snap 
table will be stored in memory immediately preceding 
the last snap table. If no address is specified for any 
snap table, the first table is stored either at the end of 
memory (RPL) or (ABS), or immediately preceding 
the last program loaded (REL). It is the programmer's 
responsibility to select the appropriate locations and 
provide sufficient SpclCc for ^11 xlis SnSLp5h.Ot LdLulcSo 


If indexed, addr^ or addi^ must be in the form:. 

val, i where val is en octal mimber from 0-777 and ^ is a number fror 0-7. 
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SNAP 


cond (OPTIONAL) - The condition which must be satisfied 
before a SNAP can be executed. If omitted, a snap 
dump will take place each time the instruction is to 
be executed. 

There are two kinds of conditions; 

1. The M/N Condition 

A snapshot dump may be executed the Mth through the 
Nth time an instruction is executed where M and N are 
decimal numbers. 

2. Comparison conditions 

The Contents of a memory location or a register are 
compared in an alphar.uinbric sense only, to the 
contents of a memory locetion, a register, or 
octal value. 

The following comparisons can be made (a and b 
represent the contents of a memory location, a 
register or a value): 

a = b a equals b 
a< b a is less than b 

a tH a y% K 

a b a is not equal to b 
The following rules govern the compared locations; 

a. Addresses of memory locations must be parenthe¬ 
sized. 

Example: (125) <5 

A snapshot dump will be given at the specified 
location when the contents of location 1258 
less than 5, (The value 5 is right justified with 
leading zeroes.) 

b. The notations A, Q, and D refer to the contents 
of the A Register, the Q Resiter and the D Regis¬ 
ter. The notation "n” (n=0, 1, 2--7) refers to 
the contents of index register n, right justified 
with leading zeros. When referring to the con¬ 
tents of a register, the parenthesesmust be omitted. 


1 
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SNAP 


Examples 


.2 > 1 

A snapshot dump will be given at the specified 
location when the contents of index register 2 are 
greater than 1. 


A # (15000) 

A snapshot dump will be given at the specified 
location when the contents of the A register are 
unequal to the contents of ISOOOg. 

c. An address can be index modified. 

Example 


(157,4) > 0 


REMARKS 


A snapshot dump will be given at the specified 
memory location when the contents of 157g modi¬ 
fied by the contents of index register 4 are nega¬ 
tive . 


* NOTE 


1. The program to be run must be loaded into memory 
prior to the appearance of the SNAP control instruc- 
tion(s). (SNAP calls may be compiled with a program 
through the use of the SNAPGEN generator.) 


2. If p/loc is the same on two or more SNAP control in¬ 
structions, the snap routines for those instructions are 
performed in the reverse order from which they were 
submitted. SNAP instructions which specify different 
addresses need not be sequenced by address. 

3. When control is returned from the SNAP routine to the 
object program, all registers except JA are restored. 

4. There is no limit to the number of SNAP instructions 
which can be given with each job, except that sufficient 
memory space should be available for snap tables (six 
locations per call). 

5. The instruction at p/ loc may not be a TIJ, TJM, TIO, 
SKC, or RPT. In addition, this instruction may not be 
under the influence of an RPT, TIO, or SKC instruc¬ 
tion, nor may it be program-modified (e.g., by EIS 


*N0TE: Since comparisons are made in an alphanumeric sence, the condition 
A^B, WHERE B + 0, can never be satisfied. 



SNAP 


EXAMPLE ONE 


EXAMPLE TWO 


or TJM). If one of these conditions is in effect (1) the 
return from the snapshot call may be to the wrong lo¬ 
cation in the object program (2) a TJM may give un¬ 
expected results, or (3) control may be transferred 
to location Zero. 

6. Illegal SNAP cards cause an exit to IXCONER. 

This example illustrates the use of a conditional snapshot 
dump: 


Location 

Command 

Address and Remarks 


JOB 

XYZ 


RPL 

4, ALPHA 

15260 

SNAP 

0; 0,3;i77,3;;A#0 


JMP 

* 


Explanation: Execution of these instructions causes pro¬ 
gram ALPHA to be loaded and run. An octal dump of lo¬ 
cations 0, 3 through 177, 3 will be performed before the 
execution of the instruction at 15260, if the contents of the 
A Register are non-zero. The SNAP table is situated in 
the last six memory locations at the end of memory. 

This example illustrates the use of an unconditional snap¬ 
shot dump: 

L Location Command Address and Remarks 
14430 SNAP F;i4P;30P 


Explanation: Execution of this instruction will cause an 
unconditional floating-point dump of the location repre¬ 
sented by the sum of 148 origin of the last REL 

program loaded through the location represented by the 
sum of 308 and the origin of the last REL program loaded 
to be performed prior to executing the instruction at 
14430L (L is assumed). 



OCT 


FUNCTION 


FORMAT 


PARAMETERS 


REMARKS 


OCT - Replaces Word(s) in Octal Format 


Replaces the contents of one or more consecutive memory 

locations with words in octal format. 


L 

Location 

Command 

Addjress and Remarks. 


loc 

OCT 

wordl,.wordn 


loc - The location of the word to be changed. 

wordl - 16 or fewer octal digits which indicate the bit con¬ 
figuration to be inserted into the first location to be 
changed. If fewer than 16 characters are specified, 
the remainder of the word is right filled with zeros. 

word n (OPTIONAL) - One or more additional parameters 
in the same format as wor dl, to be inserted into sub¬ 
sequent consecutive locations. 

If corrections are to be made to relocatable programs, the 

following information should be noted: 

1. The NAME/SYMBOL list may be stored in the 
TEMPORARY/ASTOR area of a program and if nec¬ 
essary at the area in memory starting at lOOOOg. 
However, the symbol list is cleared prior to executing 
the program. 

2. Therefore the programmer should be especially care¬ 
ful when correcting the TEMPORAR Y/ASTOR area or 
the area starting at lOOOOg so as not to affect the sym¬ 
bol list and/or its connections. If the symbol list and/ 
or its connections are affected, 32KSYS will err when 
clearing the symbol list prior to executing the program. 

3. See explanation of PORIG if LOADSETS. AVAILMEM 
or any other modification of program origin has oc¬ 
curred prior to execution of CMD, ALPHA, or OCT 
corrections. 
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cx:t 


EXAMPLE 


L Location 


Command Address and Remarks 


lOOC OCT 

200P OCT 


111111111111.222222,333 


Explanation: Execution of these instructions will replace 
the contents of the memory locations listed below with the 
following information (expressed in Octal format). 


Location 


New Contents 

Common + lOOg 


12/001 

Common + lOlg 


6/010 

Common + 1028 


3/011 

Program origin + 

N> 

O 

O 

00 

16/100 

Program origin + 

2018 

2/101 


1 


1 ^ 
I’-y 
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PMn 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


REMARKS 


CMD (or COMMAND) - Replaces Program Instruction(s) 
in Command Format 


Replaces the contents of one or more consecutive half¬ 
words in memory with instructions in command format. 


L 

Location 

Command 

Address and Remarks 

P 

loc 

CMD 

instri, addri ; ..ins^n 

addrn 


p - Position of the first half-word to be replaced. 


L (or blank) Specifies the left instruction 

R Specifies the right instruction 

loc - The locstionof the first word to be replaced. 

instri addri - The new instruction and its address, sepa- 
rated by a comma, where: 

instri is a TAC mnemonic, and 

addri is s-n address. If indexed, the form must be: 
^val, i where val is an octal number from 0-7777 
and i is a number from 0-7. 

instrn addrn (OPTIONAL) - One or more additional pa- 

rameters in the same format as that for instr i, addr i. 
Parameters within the CMD control line must be sep¬ 
arated by semi-colons. 

One or more consecutive half-words of memory, starting 
at the p half of loc, are replaced by one or more half¬ 
words designated by instr i, addr i;. instr n, 

addrn . 

1. CMD and COMMAND may be used interchangeably as 
the call for this control instruction. 

2. If the address portion of a parameter is omitted, the 
address field of the half-word to be replaced will be 
filled with zeros. 
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CMD 


3. If the address portion of a parameter is index register 
modified, the entire parameter must contain two com¬ 
mas, one between the instruction portion and val and 
one between val and i. 

4. Any errors detected will cause control to be trans¬ 
ferred to the system via IXCONER. 

5. Refer to OCT, REMARKS, concerning relocatable cor¬ 
rections. 

EXAMPLE ONE This example illustrates the use of an absolute address 

correction. 

L Location Command Address amd Remarks 
R 12120 CMD TDXL, 0, 5;CM, 17677 

Explanation: Execution of this instruction causes two 
half-words contained in memory locations 12120R, and 
12121L to be replaced by the binary representation for 
TDXL 0, 5 CM 17677. 
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CMD 


EXAMPLE TWO This example illustrates the use of a relative address cor 

rection: 


L 

Lucittiuil 

Cornrn3ind. 

Rf>rnarks 



REL 

4, CORRECT $ 

R 

210P 

CMD 

JNOL, 14P;TM0. 30C 


Explanation: Execution of the first control instruction 
above causes the program CORRECT to be loaded without 
subroutines. If SUBS were specified, the origin used for 
the corrections would be that of the last subroutine loaded 
rather than that of the program CORRECT (refer to the 
Special Function PORIG). Execution of the second control 
instruction causes the two command corrections to be 
made, starting at the right half of the word at 2108 rela * 
tive to the program origin. The firs-t command operand 
address is relative to the program origin; the second to 
COMMON. 


The results of the CMD instructions (expressed in TAC 
format) will be: 


Location 


New Contents 


Program Origin + ZlOg 
(right half) 

Program Origin + Zllg 


JNOL, Program Origin + i4g 
TMQ, CSA of COMMON + lOg 
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ALPHA 


ALPHA - Replaces WordCs) in Alphanumeric Format 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 

REMARKS 


EXAMPLE 


Replaces the contents of one or more consecutive memory- 
locations with words in alphanumeric format. 


L 

Location 

Command 

Address and Remarks 

n 

loc 

ALPHA 

replacement 


n (OPTIONAL) - The number (1-7) of words to be replaced. 
If omitted, 1 is assumed. 

replacement - Sets of eight alphanumeric characters. 
Spaces are significant. All Philco characters are 
permitted. 

n - Consecutive words starting at loc are replaced by 

replacement . 

Refer to OCT, REMARKS, concerning relocatable cor¬ 
rections. 

Alpha replacements must start at the beginning of the 
Address and Remarks field. 


L Location 


Command Address and Remarks 


3 205P 

2 11200 


ALPHA 

ALPHA 


ONEAANDA TWOAARE 
THREE,AA $ 
ABSOLUTEEXAMPLEA$ 


Explanation: Execution of these instructions causes the 
contents of the memory locations listed below to be re¬ 
placed with the following information (expressed in TAG 
format): 


Location 


New Contents 


Program Origin + 205g 
Program Origin + 2060 
Program Origin + 2070 


W/ONEAANDA$ 

w/twoaarea$ 

W/THREE,AA$ 


112000 

112010 


W/ABSOLUTE! 
W/EXAMPLEA$ 
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SECTION XII 


SPECIAL FUNCTIONS 


This category of 32KSYS control 
instructions includes those which 
perform miscellaneous computer 
operations. Among these operations 
are filling memory, relaying mes¬ 
sages to the operator via the Console 
Typewriter, and halting the com¬ 
puter. 



CLEAR 


FUNCTION 


format 


ACTION 


CLEAR - Clears Memory 


Clears all memory from location lOOOOg 

__ i AQ 

nieiiiury lu puiii;, \ 


to the end of 
psr wor d) = 


L 

Location 

Command 

Address and Remarks 



CLEAR 



All memory locations between lOOOOg and the effective 
end of memory inclusive are cleared to fixed point 
zeros. 




CLOCK 


CLOCK - Types Accounting Clock Date and Time on 
Console Typewriter 


FUNCTION 


FORMAT 


ACTION 


REMARKS 


CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUT 


CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUT 


Causes the date and time from the Accounting Clock to 
be typed on the Console Typewriter. 


L 

Location 

Command 

Address and Remarks 


_ 

CLOCK 

_ 


The date and time as indicated by the Accounting Clock 
are typed on the Console Typewriter (refer to Normal 
Type-Out , below) in the form A MM-DD HH-MM-T A:! 
and stored in the Address and Remarks field of the CLOCK 
control card before the card is written on TSYSOUT. 


1. If the CLOCK instruction is given and a computer has 
no Accounting Clock, the instruction will be ignored. 

2. If the Accounting Clock is unavailable when a CLOCK 
command is given, the Error Type'*Out, below, will 
occur and the next control instruction will be executed. 


Type Out Explanation 

date, time The CLOCK instruction was encountered 
and the date and time are typed via the 
Account Clock in the form: AAM M- 
DDAHH-MM. TA where MM-DD is the 
month and day, and HH-MM.T is the 
hour (per 24-hour day), the minute, 
and tenth of a minute. 


CLOCK The Accounting Clock was interrogated 

FAILURE but was unavailable. 
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COMMON 


COMMON - Sets Common Storage Area 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 

EXAMPLE 


Sets the length and core starting address of the common 
storage area to be used by relocatable binary programs. 


L 

Location 

Command 

Address and Remarks 



COMMON 

length, m 


length - The number (decimal) of locations to be set 
aside for Common storage. 

m - The starting address of the Common storage area. 

If a value less than 10000_ is specified, exit will 
be made to IXCONER. 

m and length are stored for use by the loader. 

Assume that a relocatable binary program is to be loaded 
and run« 


L Location Command Address and Remarks 


COMMON 596, 12000 


Explanation: Execution of this instruction causes the 
COMMON storage area to be preset to 596 locations, 
beginning at location IZOOOg . 
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ENDMEM 


FUNCTION 

FORMAT 

PARAMETER 

ACTION 

REMARKS 


ENDMEM - Sets the Effective End of Memory 

Sets the effective end of memory for System functions. 


L 

Location 

Command 

Address and Remarks 



ENDMEM 

m 


m - The new effective end of memory. 

The effective end of memory is set to m. 

The effective end of memory is reset to 11111 ^ when 
a JOB control instruction is executed. 
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FILL 


FILL - Fills Memory 


FUNCTION 

FORMAT 


PARAMETERS 


REMARKS 


ACTION 


Fills memory locations with the indicated filler. 


L 

Location 

Command 

Address and Remarks 



FILL 

addr^ , addr^ , filler 


addr ] (OPTIONAL) - The starting address of the area 
in memory to be filled. If omitted, addr ^ is auto¬ 
matically set to 100008- 

addr ? (OPTIONAL) - The ending address of the area in 
memory to be filled. If omitted ad ^2 will auto¬ 
matically be set to the effective end of memory. 

filler (OPTIONAL) - 0 to 16 octal characters. 

1. If no characters, memory specified will be filled 
With zeros. 

2. If two characters, memory specified will be filled 
with a word containing the 2 characters duplicated 
8 times. 

3. If more than two characters, memory specified 
will be filled with the characters converted and 
right justified. 

If all parameters are omitted, memory from location 
lOOOOg to the effective end of memory will be filled 
with zeros. 

All memory locations between addr^ and addr^ in¬ 
clusive are filled with filler. 
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HLT 


HLT - Halts Computer Operation 


FUNCTION 


FORMAT 


PARAMETER 


ACTION 


REMARKS 


Relays messages to the operator via the Console Type¬ 
writer and stops the computer to permit a manual oper 
ation. 


L 

Location 

Command 

Address & Remarks 



HLT 

message 


message - Fifty-six or fewer alphanumeric characters 

(including spaces) written in the Address and Remarks 
field, that compose a message to the operator. 

message is typed on the Console Typewriter. Upon com¬ 
pletion of the type-out, the computer halts, enabling the 
operator to perform the manual action specified by mes¬ 
sage. Pressing advance causes 32KSYS to read and exe¬ 
cute the next control instruction. 

When the computer stops, all ones are displayed in the 
A, Q, and D Registers, indicating to the operator that 
this is a system halt. 




IBTT 


TOTT - r!h9n<y<»Q TiiHiratnr Rita 


FUNCTION 


FORMAT 


PARAMETER 


ACTION 


Changes the bit configuration in the indicator word 
(IIBIT), which serves as a pseudo Toggle. 


L 

Location 

Command 

Address and Remarks 



IB IT 

n, n, - - -n 


n - One or more decimal numbers, 0 through 47 which 
designate the specific bit(s) to be changed (i.e., to 
change a zero to a one, or a one to a zero). 

• Each number placed in the Address and Remarks 
field as a parameter reverses its particular bit in 
IIBIT. 

• IIBIT is cleared when a JOB instruction is executed. 

• Bits in IIBIT may be sensed by the ALTAC IF 
SENSE BIT statement. 
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JMP 


FUNCTION 


PARAMETERS 


REMARKS 


JMP - Transfers Control 

Transfers control to a specified address. 


L 

— 

Loc ation 

Command 

Addres and Remarks 



jmp 

addr 


jmp - A JMP command which indicates the portion of 
the word to which control is to be transferred. 

One of the following must be selected: 

JMP Indicates the left half of the word 

JMPL Indicates the left half of the word 

JMPR Indicates the right half of the word 

addr - The address to which control is to be transferred. 

If an asterisk (*) is specified, the jump address will be 
the starting address of the last program loaded. 

JMP, JMPL and JMPR will have the same action if an 
asterisk is used as the parameter. 
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NOPRINT 


t UNCTIUN 

FORMAT 

PARAMETERS 

ACTION 


NOPRINT “ Inhibits Printing of Control Instructions 


Sets 3ZKSYS to inhibit the printing of executed control 
instructions „ 


L 

Location 

Command 

Address and Remarks 



NOPRINT 



None 

32KSYS iS ser to .nhibit the printing of executed control 
instructions untd a PRINT or a JOB nstruction \s en¬ 
countered. 
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PRINT 


FUNCTION 

FORMAT 

PARAMETER 

ACTION 


PRINT - Permits Printing of Control Instructions 

Seta 32KSYS to print executed control instructions. 


L 

Location 

Command 

Address and Remarks 



PRINT 



None 

32KSYS is set to print executed control instructions 
until a NOPRINT instruction is encountered. 
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PORIG 


FUNCTION 


FORMAT 


PARAMETER 


ACTION 


PORIG - Sets the P-Relative Address in the COMMAND 

(CMD), OCT, ana ALPHA uorrecuon xwiULiueo 


Sets the P-relative address in the COMMAND (CMD), 
OCT, and ALPHA corrective routines to the absolute 
value of the addr or to the origin of the id . 


L 

Location 

Command 

Address and Remarks 



PORIG 

addr or id 


addr - The address to be used for P-relative corrections. 

id - The identification of a program whose origin address 
will be used for P-relative corrections. 

The address represented by the parameter in the com¬ 
mand is placed in the P-relative address used by the 
COMMAND (CMD), OCT, and ALPHA correction 
routine s. 
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PROGTAPE 


PROGTAPE - Assigns a Program Tape 


FUNCTION 

FORMAT 


PARAMETER 

ACTION 

REMARKS 


Assigns a designated tape as the user's program tapco 


L 

Location 

Command 

Address and Remarks 



PROGTAPE 

t 


t - The symbolic tape onto which subsequent compiled 
programs will be written. 

All subsequent programs compiled within the current 
job will then be written on t following compilation. 

1. Any tape designated as the program tape must 
contain a block of Z's, which indicates the location 
for the storage of the next program. 

2. A PROGTAPE assignment is valid until another 
PROGTAPE or JOB control card. 


3, 



may not be a system tape. 


t 




REM 


FUNCTION 


FORMAT 


PARAMETER 


ACTION 


REM - Relays Remarks to an Operator 


Rclsys iii65 5S.g€S to tlio opoTo-tOT* VIS tlic Consolc 
Typewriter without stopping computer action. 


L 

Location 

Command 

Address and Remarks 



REM 

message 


message - Fifty-six or fewer alphanumeric characters 
(including spaces) written in the Address and 
Remarks field, that compose a messaee to the oper¬ 
ator. The characters should be acceptable to the 
Console Typewriter. (Refer to ITYPOUT, SYS 
Entries), 

message is typed on the Console Typewriter without 
stopping computer action. 
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SYSOPS 


SYSOPS - Compiler Option Word 


FUNCTION 

FORMAT 

PARAMETER 

ACTION 

REMARKS 


Changes bits in the compiler option word (ISYSOPS) 
to offer the programmer additional compiler options. 


L 

Location 

Command 

1 

Address and Remarks 



SYSOPS 

fls Xl| • s s H 


la - One or more decimal numbers, 0 through 10, which 
designate the specified bit to be changed. 

When a SYSOPS control instruction is executed, the 
designated bits are reversed in ISYSOPS for use by 
32KSYS or compilers. 

1. ISYSOPS is cleared whenever a new JOB instruc¬ 
tion is executed, 

2, Exit will be made to IXCONER if any number 
greater than 10 is specified in the Address and 
Remarks field or the SYSOPS control instruction. 

The table on the following page describes the bit 
location within ISYSOPS that may be changed at the 
programmer's discretion; 
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SYSOPS 


Bit Explanation 

0 If set, Philco 212 mnemon'c commands will be compiled into their 

proper bit configuration, otherwise such commands will be considered 
command faults, 

1 If set, POSSIBLE F-BIT ERROR will appear on the code edit whenever 
a possible F-Bit error is detected during a TAG compilation, 

2 If set, TAG will not store the intermediate code in the higher portion 
of memory. Instead, the code will be written onto TSYSGR3, and the 
memory space released will be used for the symbol table, 

3 If set, the compiler assumes that its input will be in binary-image 
mode on a tape other than TSYSIN, 

4 If set, the compiler assumes that its input will be in hollerith-image 
mode on a tape other than TSYSIN, 

5 If set, the GOBOL compiler interprets columns 1-72 only and also 
considers the 8-4 punch as the quote character rather than the semi¬ 
colon. 

6 If set, the GOBOL compiler operates in "test mode" to aid .n com¬ 
piler debugging. Intermediate compiler files are edited and added to 
the normal compiler printer output, 

7 If set, the internal loader (liNTLD) will search the tape with the 
symbolic tape name XSYSTEM. (This bit is tested only when the 
internal loader is instructed to by the object program). 

8 If set, the addr j and/or addr ^ parameters of DUMP controi. ‘nstruc- 
tions less than lOOOOg will be valid, and will permit the programmer 
to obtain dumps of the memory area reserved for 32KSYS, 

9 If set, the FORTRAN IV compiler operates in "tes* mode" to aid in 
compiler debugging; i.e, , IBITS 0-18 will be interrogated by the 
FORTRAN IV compiler, 

10 If set, all 32KSYS preset symbols are inhibited, enabling 8KSYS 

programs not requiring 8K tape libraries at compile time to be 
compiled with 32KSYS TAG, 
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SYMDEF 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


REMARKS 


SYMDEF - Defines a Symbolic Address 


Adds the defined symbolic address to the SYMBOUT 
list, and defines REFOUT's having symbolic addresses 
identical to it. 


L 

Location 

Command 

Address and Remarks 



SYMDEF 

symbol j ,m jj. 

symbol , m n 
n 


symbol - The symbol (NAME.FLAD) being defined. 

m - The address which defines symbol . 

An attempt is made to find symbol in the REFOUT list. 
If found, m is used to satisfy loading conditions. 
Whether found or not, symbol and m are then added to 
the SYMBOUT list for subsequent reference. 

If symbol is greater than 16 characters, or NAME. 
FLAD is not separated by a period, or m is not an 
octal address, or each symbol is not defined by an 
address parameter, exit is made to IXCONER. 

Each symbol must be separated from m with a comma 
(, ) and each symbol , m must be separated from the 
following symbol, m with a semi-colon (;). 





SECTION XIII 


32KSYS ENTRIES 


32KSYS Entries permit the programmer to 
make use of specialized routines used by 
32KSYS. The entries are locations within 
32KSYS which contain a transfer of control 
to a specific routine. Some routines, at 
the conclusion of their operation, return 
control to the calling program, while others 
transfer control to another 32KSYS entry. 

The programmer may use these routines by 
writing a transfer of control to the desired 
32KSYS entry. This transfer must be made 
to a symbolic address as designated herein. 
This symbolic address will be defined auto¬ 
matically by TAC when the program is com¬ 
piled. 



lADCONI 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


EXIT 


- OUilVCJ.LO LliC X-iASL X* aA dlllCtCA UA A V^OIAAAUA 

Instruction to an Octal Address 


Converts the first parameter in the Address and 
Remarks field of a control instruction to an octal ad¬ 
dress. 

SYS. lADCONI 


32KSYS and/or the programmer 


The parameter must be an asterisk (*) [ INTRYJA will 
be substituted] or an address. 

• The first parameter in the Address and Remarks 
field of a control instruction is converted and 
stored in the A Register. Spaces are suppressed. 

• Termination of the first parameter is determined 
by the appearance of a comma, dollar sign, slash, 
semi-colon, "equal" sign, "greater than" sign, 
right or left parentheses or number sign. The 
termination character is stored in IBRKSTR right 
justified with leading zeros. 

• If an error is detected, exit is made to IXCONER, 

Control is returned to the next sequential instruction in 
the calling program. 
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FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 

EXIT 


lADCONC 

lADCONC - Converts the Next Parameter of a Control 
Instruction to an CXtal Address 


Converts the next parameter in the Address and Remarks 
field of a control instruction to an octal address. 

SYS. lADCONC 


32KSYS and/or the programmer 


SAME AS lADCONI (refer to lADCONI) 

SAME AS lADCONI (refer to lADCONI) 

Control is returned to the next sequential instruction in 
the calling program. 
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1CLOCK 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


EXIT 


1C LOCK - Obtains and Edits the Clock Word 


Obtains and edits the clock word. 
SYS. 1 CLOCK 


32KSYS and/or the programmer 


None 


The clock word is edited in the following form; 

A Register = AAMM-DDA 
Q Register = HH-MM.TA 

where MM = Month 
DD = Day 
KH = Hour 

\ J( — \ £2 _ 

IVilVi — iVXiliULC 

T = Tenth of minute 

Control is transferred to the next sequential instruction 
in the calling program. 
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lENCODE 


lENCODE - Image to Code Conversion 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 


ACTION 


EXIT 


REMARKS 


Converts an Image Mode card of 2n consecutive core 
memory locations into the corresponding Code Mode 
card of n consecutive core memory locations. 

SYS. lENCODE 


32KSYS and/or the programmer 


The A-register should contain a word with bits 
0 = 0 

1-15 = IMAGE 
24 = 0 

25-39 = CODE 
40 = 0 

41-47 = n (if bits 41-47 are zero, n is set 
equal to 1). 

IMAGE is defined as the address of the first Image 
Mode word and CODE is defined as the address of the 
first Code Mode word. 

The Image Mode card is converted into the correspond¬ 
ing Code Mode card with each illegal Image Mode 
character represented in Code Mode by a question mark. 
The Code Mode characters are defined in Philco 2000 
Code Combination Card, TF-17. 

Control is returned to the next sequential instruction in 
the calling program. 

If the Image and Code areas overlap, then CODE (the 
address of the first code) must not fall between IMAGE 
+ 2 through IMAGE + 2n -1 inclusive. 
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1 END JOB 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


1 END JOB - End of Job Routine 


Terminates a job. 
SYS. lENDJOB 


32KSYS and/or the programmer 


• Snaps are edited if any were written. 

• A search for the next JOB control instruction is 
initiated. 

When a JOB control instruction is found: 

1. All tapes except those assigned to system 
pun's and those held for the next job are 
rewound with lockout 

2. All symbolic tape names except system symbolic 
tape names and those held for the next job are 
released 

3. An end of job message is written on TSYSOUT 

4. TSYSDMP is rewound 

5. The JOB control instruction is executed. 
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lERRDMP 


lERRDMP - Error Dump Routine 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


Initiatsi 32KSYS post-mortem dumping. 
SYS. lERRDMP 


The programmer 


Whenever control is transferred to the 32KSYS post¬ 
mortem dump routine, either via lERRDMP, IZERO 

or ISUBERR, the following action takes place: 

e The contents of all addressable registers are saved. 

e A type-out occurs on the Console Typewriter, 

signifying that a post-mortem dump is to be per¬ 
formed. A zero, 2, or 3 within the type-out 
indicates the memory location to which control 
was transferred. 

e If dumps are specified, snaps were written, or 
an error message is indicated, the dump edit 
routine is called. 

e TSYSDMP is used as an intermediate tape by the 
dump edit routine. 

e A search for the next JOB control instruction is 
initiated. 

When a JOB control instruction is found: 

1. All tapes except those assigned to system PUN's 
and those held for the next job are rewound with 
lockout 

2. All symbolic tape names except system symbolic 
tape names and those held for the next job are 
released 

3. An end of job message is written on TSYSOUT 

4. TSYSDMP is rewound 

5. The JOB control instruction is executed. 
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lERRDMP 


CONSOLE Type-Out Explanation 

TYPEWRITER 

ERROR ERRDMP2 A programmed transfer of control 

TYPE-OUT to lERRDMP 
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IGETBL 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 

EXIT 

REMARKS 

EXAMPLE 


IGETBL • Gets Blanks During Scanning 


Preset! the ISCANON subroutine to recognize (not 
suppress) spaces in the parameters contained in the 
Address and Remarks field of a control instruction. 

SYS. IGETBL 


32KSYS and/or the programmer 


None 


ISCANON is set to recognize spaces. 

Control is returned to the next sequential instruction 
in the calling program. 

IGETBL has no effect on the ISCAN subroutine because 
ISCAN automatically resets itself to suppress spaces 
each time it is executed. 

Refer to ISCANON for examples using the five scan 
subroutines. 
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lIGBL 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 

EXIT 

REMARKS 

EXAMPLE 


lIGBL - Ignore Blanks During Scanning 

Presets the ISCANON subroutine to suppress spaces in 
the parameters contained in the Address and Remarks 
field of a control instruction. 

SYS. lIGBL 

3ZKSYS and/or the programmer 

None 


ISC ANON is set to suppress spaces. 

Control is returned to the next sequential instruction in 
the calling program, 

lIGBL has no effect on the ISCANBL subroutine because 
iSc^ANcL automatically resets itself to recognize spaces 
each time it is executed. 

Refer to ISCANON for examples using the five scan 
subroutines. 
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lINTCMD 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


REMARKS 

EXIT 


lINTCMD - Executes a 32KSYS Control Instruction 


Execute* a 32KSYS control instruction. 
SYS. lINTCMD 


The programmer 


Index register 7 contains the address of the first word 
to be loaded into lCONLIN+1. 

• lCONLIN+1 to lCONLIN+9 is loaded. 

• The 32KSYS control instruction in ICONLIN +1 to 
ICONLIN +9 is executed. 

• If an error occurs while executing the 32KSYS 
control instruction, exit is made to IXCONER. 

• Index register 7 contains, on exit, the address 
of the last word transferred+1. 

The format of the control instruction may be in Con¬ 
sole Typewriter format (See Operating Procedures, 
Special Operator Actions) or standard 32KSYS card 
format. 

Control is returned to the next sequential instruction 
in the calling program. 
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lINTCON 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 

EXIT 

REMARKS 


lINTCON - Loads ICONLIN ^ 1 to ICONLIN + 9 


Loads lCONLIN+1 to lCONLIN+9 with specified 
memory. 

SYS. lINTCON 


The programmer 


Index register 7 contains the address of the first word 
to be loaded into iCONLIN+1. 

• iCONLIN+i to lCONLIN+9 is loaded from internal 
memory. 

• Index register 7 contains on exit the address of 
the last word transferredr 1. 

Control is returned to the next sequential instruction 
in the calling program. 

See also IXECUTI. 
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lINTLD 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 


lINTLD - Internal Loader 


Loads a program 
SYS. lINTLD 


32KSYS and/or the programmer 


The A and Q Registers contain: 


1. The identification ^ of the program to be loaded 

in the A Register. The id must be eight characters 
or fewer, left-justified and space-filled to the 
right if necessary. 


2. The following specified bit designations are to be 
placed in the O Register: 


Bits 18-23 The program unit number (PUN) 
on the tape on which the program 
is stored. 


Bit 


Bit 44 


Bit 45 


If set to one, bit ? of ISYSOPS will 
be checked for loading from an 
alternate system tape. 

If set to one, control is to be trans¬ 
ferred to the starting address of the 
program after it is loaded. 

If set to one, the direction of the 
search will be backward. 


Bit 46 


If set to one, an ABS program is to 
be loaded. 


Bit 47 


If set to one, an RPL program is to 
be loaded. 


CAUTION: If Bits 46 and 47 are zero, an exit will be 

made to IXCONER. If more than one of these bits is 
given, bit 47 will be assumed to be the correct bit. 


13-13 



lINTLD 


ACTION 


REMARKS 


EXAMPLE 


• If Bits 43 and 45 are zero, the tape specified by 
the Q Register will be searched forward for the 
program specified by id. K the program is not 
found before encountering a block of Z's the tape 
will be searched backward. If the program still 
cannot be foimd before encountering "begin tape", 
exit will be made to IXCONER. 

• If bit 45 is one, the tape specified will be searched 
backward only. 

• If bit 43 is one and bit 7 of 1 SYS OPS is one, a tape 
with the symbolic name XSYSTEM, rather than the 
PUN in the Q Register, will be searched. 

• Control will be transferred to the loaded program 
if bit 44 of the Q Register is set to one, otherwise 
control is returned to the next sequential instruc¬ 
tion in the calling program. 

1. Internal loader calls may be inserted in a program 
during compilation by use of the internal load gen¬ 
erator, LOADGEN (Library routines). 

The following example illustrates the calling of a program 

into memory by another program during the latter's exe¬ 
cution. 


L Location Command 


Address and Remarks 


TMA W/SEGl $ 

TMQ N/6 T23; 1/1 T47$ 

JMP SYS.IINTLD 


Explanation: Execution of these instructions causes 
the program SEGl to be loaded into memory and control 
returned to the next sequential instruction in the calling 
program. 
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IMEMSIZ 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


i^Ai 1 

REMARKS 


IMEMSIZ - Checks Memory Overflow 


Tests the given address for memory overflow. 
SYS. IMEMSIZ 


32KSYS and/or the programmer 


The A Register contains the address to be tested at 
T39. 

• The specified address is tested against the effective 
end of memory. 

• If the address is legal, the Q Register is made 
zero. 

• If the address is illegal, the Q Register is made 
all ones. 

• The A Register contains the effective end of 
memory +1 at T39. 

Control is returned to the next sequential instruction 
in the object program. 

The effective end of memory, reset by the JOB control 
instruction to 77777g , can be changed by the ENDMEM 
control instruction. 
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INXTCRD 

FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


EXIT 

REMARKS 


INXTCRD - Obtains the Next Card 


j-1- 


. ... .. . A. —.j X/ /-krl o / • 

UDtains trom iDiDiiN me next uctxu m -- 

verting from Image, if necessary) and stores it in the 
ten memory locations beginning at ICONLIN. 


SYS. INXTCRD 


32KSYS and/or the programmer 


If Bit 43 of ICONBIT is set to one and the mode of input 
is image, only the command field will be converted to 
Code Mode and transferred to lCONLIN+2. Other data in 

• The location of the first word of the next card, 
which was read into an input buffer area in 
memory as part of a block from the system 
input tape is stored in Index Register 1. 

• If input is in Code Mode, the ten words in the 
buffer area which compose the next card will be 
transferred directly to ICONLIN. 

• If input is in Image Mode, it will automatically be 
converted to Code Mode during its transfer to 
ICONLIN (subject to Bit 43 of ICONBIT), and the 
location of the image card in the buffer area will 
be placed into Index Register 1. Illegal Image 
Mode characters appear as question marks (?) in 
Code Mode. 

Control is returned to the next sequential instruction 
in the calling program. 

If a JOB card is encountered, an exit will be made to 
IXCONER, 


1C ON L IK rei 
unchangec 
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INXTCON 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


EXIT 


INXTCON - Next Control Instruction Routine 


Obtains and executes the next control instruction. 
SYS. INXTCON 


32KSYS and/or the programmer 


• Snaps are edited, if any were written. 

• The next control instruction is obtained from 
the ten memory locations starting at ICONLIN 
via the INXTCRD routine. 

• When the instruction is obtained, the command 
field is interpreted. 

• The NAME/SYMBOL list is cleared if any 
had been established. 

If the control instruction is legal, it will be executed. 

Illegal instructions cause a transfer to IXCONER. 
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1 ■DTJTT'nV 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 

EXIT 


IPRTCON - Writes ICONLIN on TSYSOUT 

Writes ICONLIN to lCONLIN+9 on TSYSOUT 
SYS. IPRTCON 


32KSYS and/or the programmer 


ICONLIN to lCONLIN+9 is edited for printing (data 
select 0, line feed 1, and end of line character) and 
is written on TSYSOUT. 

Control is returned to the next sequential instruction 
in the calling program. 
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IPRTMSG 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 

EXIT 


IPRTMSG - Writes Message on TSYSOUT 

Writes message on TSYSOUT 
SYS. IPRTMSG 


32KSYS and/or the programmer 


The fifteen words beginning at IMSGCON are edited 
for printing (data select 0, line feed 1, and end of line 
character) and are written on TSYSOUT. 

Control is returned to the next sequential instruction 
in the calling program. 
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IPRTRUN 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 

EXIT 


IPRTRUN - Empties Buffer for TSYSOUT 

Empties buffer for TSYSOUT 
SYS. IPRTRUN 

32KSYS and/or the programmer 

The output buffer for TSYSOUT is emptied. 

Control is returned tq the next sequential instruction 
in the calling program. 
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IPUNSYM 


IPUNSYM - Finds Symbolic Tape Name 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 


Finds a symbolic tape name, referencing a given 
program unit number (PUN). 

SYS. IPUNSYM 


32KSYS and/or the programmer. 


The A Register contains a PUN at T23. 


If the PUN is illegal or undefined, exit is made to 
IXCONER. 

If the PUN is legal, the first symbol in 32KSYS's 
symbolic tape name list assigned the given PUN is 
left in the A Register left-justified with trailing 
blanks. 


EXIT 


Control is returned to the next sequential instruction 
in the calling program. 



ISCAN 


ISC AN - Scans the First Parameter of a Control 
Instruction Suppressing Spaces 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 




the first parameter contained in the Address and Remarks 
field of a control instruction. 


SYS. ISCAN 


32KSYS and/or the programmer 


None 


• The first parameter in the Address and Remarks 
field of a control instruction is scanned and stored 
in IWRDl and 1WRD2. Spaces are always sup¬ 
pressed. 

• Termination of the first parameter is determined 
by the appearance of a standard 32KSYS break 
character (a comma, semi-colon, slash, period, 
or dollar sign). 

e All characters of the first parameter (a maximum 
of 16) are stored upon exit from the subroutine in 
iWRDl and 1WRD2, acting as a double-length 
register. The characters are stored right-justified 
with leading zeros. 

e The number of characters recognized by the 
ISCANBL, ISCAN, ISCANON subroutines is 
stored in the left-address portion of ICHARCT 
prior to the exit from the subroutine. 

e Because the subroutine stores 16 or fewer charac¬ 
ters, the results are not guaranteed if more than 
16 are used. 


EXIT 


Upon completion of the subroutine, control is returned 
to the next sequential instruction in the calling program. 



ISC AN 


REMARKS 


EXAMPLE 


1. ISCAN always suppresses spaces within the first 
parameter. 

2. If additional parameters of the same control line 
are to be scanned, ISC ANON must be used. 

Refer to ISCANON for examples using the five scan 
subroutines. 
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ISCANBL 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


EXIT 

REMARKS 

EXAMPLE 


IQnAXTTJT CiTVs^^owafoT* nf 9 Control 

Instruction Recognizing Spaces 


Initializes the 32KSYS scanning subroutine and stores 
the first narameter contained in the Adoress and 
Remarks field of a control instruction. Spaces are 
recognized (not suppressed). 

SYS. ISCANBL 


32KSYS and/or the programmer 


• The first parameter in the Address and Remarks 
field of a control instruction is scanned and stored 
in IWRDl and 1WRD2. Spaces are relevant. 

• Termination of the first parameter is determined 
by the appearance of a standard 32KSYS break 
character (a comma, semi-colon, slash, period 
or dollar sign). This break character appears in 
the A Register and SYS, IBRKSTR at exit, right- 
justified with leading zeros. 

• All characters of the first parameter (a maximum 
of 16) are stored in IWRDl and 1WRD2, acting as 
a double-length register. The characters are 
stored right-justified with leading zeros. 

• The number of characters recognized by the 
ISCANBL, ISCAN, and ISCANON subroutines is 
stored in the left address portion of ICHARCT just 
prior to the exit from the subroutine. 

• Because the subroutine stores 16 or fewer charac¬ 
ters, the results are not guaranteed if more than 16 
are used. 

Upon completion of the subroutine, control is returned 

to the next sequential instruction in the calling program. 

If additional parameters of the same control line are 

to be scanned, ISCANON must be used. 

Refer to ISCANON for examples using the five scan 

subroutines. 
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ISCANON 

ISCANON - Scans Additional Parameters of a Control 
Instruction 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


REMARKS 


EXAMPLE 1 


Continues the scanning process begvin by ISCANBL or 
ISCAN by storing the next parameter contained in the 
Address and Remarks field of a control instruction. 

SYS. ISCANON 


32KSYS and/or the programmer 


The same action listed for ISCAN and ISCANBL, except 
that the parameter beginning at the first column follow¬ 
ing the last break character encountered is scanned and 
stored. The use of ISCANBL or ISCAN must precede 
the use of ISCANON otherwise unpredictable results 
will occur. 

1. Additional ISCANON calls must be given for 
subsequent parameters to be scanned. 

2. ISCANON is always initially set by ISCANBL to 
recognize spaces or by ISCAN to suppress spaces. 

3. The automatic setting of ISCANON to suppress or 
recognize spaces continues through each subsequer t 
use of ISCANON until changed by a IGETBL or 
lIGBL call. 

Assume that the Address and Remarks field of a contrci 
line stored in ICONLIN contains the following charac - 
ters: 


A5, r.ARr.A/ PARF .vwvAr, $ 

L Location Command Address and Remarks 


JMP SYS. ISCAN 

Explanation: Execution of this instruction causes the 

first parameter (terminated by the comma) to be scanned 
and characters ^ within it to be placed in 
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ISCANON 


IWRDi as W/00000000 
1 iirTj -> Q w / nnnnnnn^ 

X rr 4.\ Of — 

The break character (, ) is placed in the A Register and 
IBRKSTR as 

W/0000000, 

The number of characters (i) is placed in iCHARCT as 

C/HLT, 1 

L Location Command Address and Remarks 


JMP SYS. ISCANON 

Explanation: Execution of this instruction causes the 
second parameter (terminated by a slash) to be scanned 
and the characters within it (OABCA) to be placed in 

IWRDl as W/00000000 

iijtrrir>o iir/nnnnnATi/” 

1VVx\JLJ^ dO 

The break character {/) is placed in the A Register and 
IBRKSTR as 


W/0000000/ 

The number of characters (3) is placed in ICHARCT as 

C/HLT, 3 

Note that leading zeros must be determined by the 
character count. 

L Location Command Address and Remarks 


JMP SYS.IGETBL 

JMP SYS. ISCANON 


Explanation: Execution of these instructions causes 
the third parameter (terminated by a dollar sign) to be 
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ISCANON 


scanned and the characters within it (DAEF /VWWl ) to 
be placed in 


IWRDl as W/OOOOOODA 
1WRD2 as W/EFAAWy^ 

The break character ($) is placed in the A Register and 
IBRKSTR as 


w/ooooooo$ 

The number of characters (10) is placed in ICHARCT 
as 


C/HLT, 10 

EXAMPLE TWO Assume that the Address and Remarks field of a control 

line stored in ICONLIN contains the following charac¬ 
ters: 


A5, OABCA/DAEFAAAAAG$ 

L Location Command Address and Remarks 


JMP SYS.ISCANBL 

Explanation: Execution of this instruction causes the 
first parameter (terminated by a comma) to be scanned 
and characters, A5, within it to be placed in 

IWRDl as W/OOOOOOOO 
1WRD2 as W/000000A5 

The break character (, ) is placed in the A Register and 
IBRKSTR as 


W/0000000, 

The number of characters (2) is placed in ICHARCT 
as 


C/HLT, 2 



ISCANON 


L Liocation Command Address and Remarke 


JMP SYS. ISCANON 

Explanation: Execution of this instruction causes the 
second parameter (terminated by a slash) to be scanned 
and the characters within it (OABCA) to be placed in 

IWRDl as W/00000000 
1WRD2 as W/OOOOABCA 

The break character (/) is placed in the A Register and 
IBRKSTR as 


W/0000000/ 


The number of characters (5) is placed in ICHARCT as 


C/HLT, 5 


L Location Command Address and Remarks 


JMP SYS. iIGBL 

JMP SYS. ISCANON 


Explanation: Execution of these instructions causes the 
third parameter (terminated by a dollar sign) to be 
scanned and the characters within it (DAEFAAAAAG) 
to be placed in 

IWRDl as W/00000000 
iWRDJ as W/OOOODEFG 

The break character ($) is placed in the A Register and 
IBRKSTR as 


W/ 0000000$ 

The number of characters (4) is placed in ICHARCT 
as 


C/HLT, 4 
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ISTRIPQ 


FUNCTION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

ACTION 

EXIT 


ISTRIPQ - Strips the Q Register of Spaces 

Suppresses space characters in a word. 

SYS. ISTRIPQ 

32KSYS and/or the programmer 

The word to be stripped is in the Q Register. 

All spaces are deleted from the word in the Q Registero 

The stripped word is then transferred to the A Register, 
right-justified with leading zeros. 

Control is returned to the next sequential instruction 
in the calling program. 
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1STIBERR 


i? UNC i ION 

SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


REMARKS 


CONSOLE 

TYPEWRITER 

TYPE-OUT 


ISUBERR - Subroutine Error Exit 


Initiates 


puat-IIlUlLCili uumpm^. 


SYS. ISUBERR 


Philco 2000 Subroutines and/or the programnner. 


The contents of the JA Register are saved. Control 
is transferred to the same 32KSYS post-mortem dump 
routine as that used by lERRDMP. Actions, except 
the type-out, listed for lERRDMP apply to ISUBERR. 

If the programmer wishes, he may replace the auto¬ 
matic post-mortem dump entrance in ISUBERR w;th 
an entrance to his own routine. ISUBERR is reset 
to the standard 32KSYS function by the execution of a 
JOB control instruction. 


Type-Out 


Explanation 


ERRDMP3 A programmed transfer of control 

to ISUBERR. 
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ITAPENO 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 


ACTION 


REMARKS 


EXIT 


ITAPENO - Obtains a Program Unit Number (PUN) 


Obtains a program unit number (PUN) for the given 
parameter. 

SYS. ITAPENO 


32KSYS and/or the programmer 


The A Register contains the input parameter left 
justified with trailing blanks. 

The parameter is either: 

1. A symbolic tape name (a TAC symbol of 7 or 
fewer characters) or, 

% 

2, A system PUN in Binary Coded Decimal. 

• The parameter is checked for legality. 

• If the parameter is illegal, exit will be made to 
IXCONER. 

• If the parameter is a PUN, the A Register will 
contain the PUN (in binary) at T23 on exit. 

• If the parameter is a symbolic tape name, the 
symbolic tape name list will be searched. If the 
name is there, its associated PUN will be in the 
A Register at T23 on exit. If the name is not 
there, it is inserted in the list, a PUN is assigned, 
and that assigned PUN will be in the A Register at 
T23 on exit. 

At entrance, if the last character in the A Register is a 
slash (/), octal 61, instead of a blank, 32KSYS legalizes 
the assigned PUN for writing. 

Control is returned to the next sequential instruction in 
the calling program. 


1 



ITYPOUT 


TrTTMfT'TQM 

SYMBOLIC 

^ T-M-sTJ TTCQ 
. \ -lJxv 

PREDOMINANT 

USER 

PRESET 

REQUIREMENTS 

EXIT 

REMARKS 


ITYPOUT - Console Typewriter Type-Out 


Tvnps ainhanumeric characters from memory on the 

^ / r ~ ' t- 

Console Typewriter. 

SYS. ITYPOUT 


32KSYS and/or the programmer 


The A Register should contain: 

C/HLT, m;C/HLT, n 

where m is the address of the first of n words to be typed 
on the Console Typewriter. 

Control is returned to the next sequential instruction 
in the calling program. 

1, Trailing full words of spaces are not transmitted 
to the Console Typewriter, 

2„ The maximum number of characters per line of 
typeout is limited to the length of the Console 
Typewriter line (approximately 70 characters). 

Any number of lines may be typed using the 
carriage return character (octal 32) when appropri¬ 
ate . 
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IXCONER 


FUNCTION 

SYMBOLIC 

ADDRESS 

USER 

PRESET 

REQUIREMENTS 

ACTION 


EXIT FROM 
ROUTINE 

REMARKS 

ERROR 

MESSAGES 


IXCONER - Control Line Error Routine 


Causes an error message to be written on TSYSOUT and 
32KSYS post-mortem dximping to be initiated. 

SYS. IXCONER 


32KSYS only 


None 


Whenever control is transferred to IXCONER, the 
following action takes place: 

e An error indication is typed on the console type¬ 
writer (See ERROR MESSAGES). 

e The contents of the JA Register are stored in the 
left address portion of INTRYJA. 

• An error message is written on TSYSOUT, (See 
ERROR MESSAGES. ) 


Following the type-out, control is transferred to the 
32KSYS post-mortem dump routine (refer to lERRDMP). 


Those 32KSYS error messages that are flagged by an 
asterisk in the following table inhibit the 32KSYS post¬ 
mortem dumping routine from producing dumps, even 
though requested by DUMP control instructions. 


Type-Out 


Printout 


SYSEl 
♦SYSE2 
SYSE3 
SYSE4 
SYSE5 
SYSE6 
SYSE7 
SYSE8 
SYSE9 
SYSEIO 
SYSEl1 


PROGRAM NOT ON SPECIFIED TAPE 
CHECKSUM ERROR 
PROGRAM ORIGIN IN LIST AREA 
PROGRAM ORIGIN IN COMMON AREA 
UNDEFINED REFOUT(S) 

ILLEGAL CARD 

SYMBOL LIST OVERFLOW 

ILLEGAL SECTION WORD 

ILLEGAL TAPE NAME 

TAPE NAME PREVIOUSLY DEFINED 

ILLEGAL ADDRESS PARAMETER 
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lAUUMlliK 


ERROR 

MESSAGES 

(Continued) 


Type-Out 


Piirtout 


SYSE12 

SYSE13 

SYSE14 

*SYSE15 

SYSE16 

^:=SYSE17 

=:=SYSE18 

SYSE19 

^:=SYSE20 

SYSE21 

SYSE22 

*SYSE23 

SYSE24 

SYSE25 

SYSE26 

SYSE27 

SYSE28 

-SYSE29 

SYSE30 

SYSE31 

-SYSE32 

SYSE33 

SYSE34 

SYSE35 

SYSE36 

=:=SYSE37 

=:=SYSE38 

SYSE39 

SYSE40 

SYSE41 

SYSE42 

SYSE43 

SYSE44 

SYSE45 


ILLEGAL PUN 
TOO MANY PARAMETERS 
PUN TABLE OVERFLOW 
JOB CARD INTERCEPTED 
UNACCOUNTABLE MACHINE OR 
SYSTEM ERROR 

ILLEGAL SYS CONTROL INSTRUC¬ 
TION 

ILLEGAL MNEMONX 
ILLEGAL decimal NUMBER 
ILLEGAL POS.TVON FOR BINARY 
POINT 

PARAMETER'S) MASSING 

SYMBOL NOT IN SYMBOL LIST 

ILLEGAL FROM-rO PARAMETER 

PARAMETER TOO LONG 

COMMON S.ZE EXCEEDS MEMORY 

ILLEGAL BREAK CHARACTER 

ILLEGAL MAGTAPE 

NAMEXLAD TOO LONG 

ILLEGAL NUMBER OF WORDS TO 

BE REPLACED 

ILLEGAL PARAMETER 

TSYSTEM TSYSiN. TSYSL.B CANNOT 

BE WRITE-ENABLED 

ILLEGAL PROG TAPE 

ILLEGAL OCTAL NUMBER 

TOO MANY BLOCKS TO BE READ 

FORMAT FOR .NTERNAL LOADER 

NOT SPEC-F.ED 

READING TO SENTINEL WILL 

EXCEED MEMORY 

NO ADDRESS iN LOCATION FIELD 

ILLEGAL FORMAT 

NEW COMMON BLOCK LENGTH 

EXCEEDS OLD 

PROGRAM ORXIN EQUALS ZERO 
ILLEGAL USE OF TSYSIN IF SYS 
IN MAGTAPE MODE 
ILLEGAL START-END PARAMETER 
THIRD PARAMETER NOT (MASTERi 
MASTER PROGRAM NOT DEFINED 
SEGMENT AREA EMPTY 
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IXCONER 


ERROR 

Type-Out 

MESSAGES 

(Continued) 

SYSE46 


SYSE47 


SYSE48 

SYSE49 

SYSE50 


SYSE51 

SYSE52 


SYSE53 


SYSE54 


SYSE55 

SYSE56 

SYSE57 


SYS E58 


Printout 

A SYMBOL DEFINED MORE THAN 
ONCE WAS REFERENCED 
A REFERENCE SYMBOL WAS RE¬ 
DEFINED 

ILLEGAL TO LOCATE ON TSYSIN 
RELATIVE CSA EXCEEDS PMAX 
LIB MUST BE USED IF SUBS OR 
NOSUBS SPECIFIED 
ILLEGAL LIBRARY TAPE 
MORE THAN 7 LIBRARY TAPES 
SPECIFIED 

PARAMETER(S) SPECIFIED MORE 
THAN ONCE 

REFERENCE TO UNDEFINED 
COMMON BLOCK 
TAPE NAME TABLE OVERFLOW 
PARAMETER im ILLEGAL 
PARAMETER im MISSING 

Illegal CSA 
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IXECUTI 


IXECUTI - Executes the Control Line in ICONLIN + 1 
to ^CONLIN ^ 9 


FUNCTION Executes the control line in lCONLIN+1 to lCONLIN+9. 

SYMBOLIC SYS. IXECUTI 

ADDRESS 

PREDOMINANT The programmer 

: SER 

i-LESET None 

REQUIREMENTS 

ACIJON The 32KSYS control instruction in ICONLIN +1 to 

ICONLIN +9 is executed. 

If an error occurs, exit is made to IXCONER. 

■ Control is returned to the next sequential instruction 

in the calling program. 

■ FMARKS See also lINTCON. 
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IZERO 


FUNCTION 


SYMBOLIC 

ADDRESS 

PREDOMINANT 

USER 

ACTION 


REMARKS 


CONSOLE 

TYPEWRITER 

TYPE-OUT 


IZERO - E3qx)nent Fault Exit 


Initiates 32KSYS post-mortem dumping for a floating 
point exponent fault. 

SYS. IZERO 


The programmer 


Control is transferred to the 32KSYS post-mortem dump 
routine, the same as that used by lERRDMP. All actions 
listed for lERRDMP, except the type-out, apply to 
IZERO. 

1. An exponent fault occurs whenever a floating 
point operation generates an exponent which 
cannot be entirely contained in the exponent 
field. 

2. If the programmer wishes, he may replace the 
automatic post-mortem dump entrance in 1 ZERO 
with an entrance to his own routine. IZERO will 
be reset to the standard 32KSYS function by exe¬ 
cution of a JOB control instruction. 


Type-Out 


Explanation 


ERRDMPO 


A programmed transfer of control 
to IZERO. 


15-5 / 



SECTION XIV 


3 2KSYS SERVICE ROUTINES 


CALLING 

SERVICE 

ROUTINES 


32KSYS Service Routines aid the programmer in perform¬ 
ing routine functions of tape maintenance, debugging and 
program monitoring. They are located on TSYSTEM in 
RPL format and are called via their program identity as 
described below. Any or all of their particular functions 
are then performed depending upon the programmer's use 
of optional control instructions recognized by the routine 
itself. These control instructions, including the com¬ 
mand, parameters, and break characters, are written in 
the same manner as that described for 32KSYS control 
lines. 

Service routines may be called via their corresponding 
32KSYS control lines (AIDE, TACSERV, RPLC, etc.). 
Execution of the instruction in the following example 
causes the service routine AIDE to be called into opera¬ 
tion: 


L Location Command Address and Remarks 


AIDE 



AIDE 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT-OUTPUT 
SYSTEM 

CONTROL 

INSTRUCTIONS 


OIU£Xt tXKHJ A 


Copies and/or compares information contained on mag¬ 
netic tapes. 

The AIDE service routine may be called into operation by 
the following instruction: 


L 

Location 

Command 

Address and Remarks 



AIDE 



AIDE uses 32KSYS XORD for all tape operations. 


AIDE accepts control instructions, written in standard 
32KSYS control line format: 


Instruction Function 

COPY Copies information without change 

from one tape to another. 


COMPF 


Compares information on two tapes in 
a forward direction. 


COMPB 

COPYCOMP 


SPACEF 

SPACEB 

LOCTACL 

LOCREL 


Compares information on two tapes in 
a backward direction. 

Copies information without change 
from one tape to another and then 
compares the information copied by 
reading both tapes in a backward 
direction. 

Spaces forward over a tape. 

Spaces backward over a tape. 

Locates a TACL (code mode) program. 
Locates ah REL program. 
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AIDE 


COPY 


Format 


Parameters 


Instruction 

Function 

LOCRPL 

Locates an RPL program. 

LOCSENT 

Locates a sentinel block. 

WRTABS 

Writes an ABS program. 

WRTSENT 

Writes a sentinel block. 

REWIND 

Rewinds one or more tapes. 

ENDALL 

Terminates the AIDE service routine. 

LOCABS 

Locates an ABS program. 

REWINDLO 

Rewinds with lockout one or more 
tapes. 


The functions of REWIND, REWINDLO, LOCABS, 
LOCREL, LOCTACL, LOCRPL, LOCSENT, WRTABS, 
WRTRPL, and WRTSENT are as described in Tape 
Handling. 


Copies information without change from one magnetic 
tape to another. 


L 

Location 

Command 

Address and Remarks 



COPY 

COPY 

tl, t2, sent, c 

. -- 1 ____ 


1^1 - The symbolic tape from which information is to be 
copied, 

^ - The symbolic tape to which information is to be copied, 
n - The number (decimal) of blocks. 

sent - The sentinel word to be used in locating a sentinel 
block. 
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AroE 


Action 


£ (OPTIONAL) - The mode of output to be used in indicating 
the number of blocks copied if sent is specified. If the 
parameter is omitted, T is assumed. 


F Indicates the (jonsoie Type'^riter. 

T Indicates TSYSOUT, edited for the High-Speed 
Printer with Data Select 0. 

B Both F and T. 

If n is specified, 

• n blocks of information are copied from tj to tzi 

• jtj and£2 are positioned after the last block copied. 
If sent is specified. 


• information is copied from tl to t2 until a sentinel 
block of sent is encountered; 


the sentinel hlcch from tl 


written twice On t2 &riu. 


t2 is positioned between the sentinel blocks; 
tl is positioned after the sentinel block. 


Example 


L Location Command 


Address and Remarks 


COPY 4, T-14, 512 

COPY 6, T-14, ZZZZZZZZ 


Explanation: Execution of the first instruction causes 
512 blocks of information from system program unit 
number 4 to be copied onto T-14. Execution of the 
second instruction causes the information from system 
program unit number 6 to be copied onto T-14 until a 
sentinel block of W/ZZZZZZZZ is detected. 



AIDE 


COMPF 


Format 


Parameters 


Action 


Compares information on one magnetic tape with informa¬ 
tion on a second magnetic tape by reading both tapes in a 
forward direction. 


L 

Location 

Command 

Address and Remarks 



COMPF 

COMPF 

_tl,£2. ni£ 

£ 1 , t2, sent, c 


_ti - The first symbolic tape to be compared. 

_t2 - The symbolic tape to be compared with the first, 
n - See COPY 
sent - See COPY 

£ (OPTIONAL) - The mode of output to be used for indi¬ 
cating inequalities. If the parameter is omitted, T 
is assumed and only the result of the comparison 
(DIFFERENCES or NO DIFFERENCES) will be wrjtien 
on TSYSOUT. 

F Indicates the Console Typewriter. 

T Indicates TSYSOUT, edited for the High-Speed 
Printer with Data Select 0. 

B Both F and T. 

• _ti is compared with £2 21 s specified by n or sent. 


If sent is specified, the sentinel blocks are also 
compared. 

If sent is specified, the comparison is terminated 
when a sentinel block of sent is encountered on tj. 

Inequalities are recorded on c. 

The tapes are positioned after the last block com¬ 
pared. 
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revision 4-t5 


AIDE 

Example 


COMPB 

Format 

Remarks 


GOPYCOMP 

Format 


L L/Ocation L-ommand 


Address and Remarks 


COMPF 4,T-14,512,T 

COMPF 6, T-14, ZZZZZZZZ, F 


Explanation; Execution of the first instruction causes 
512 blocks of information on system program unit number 
4 to be compared in a forward direction with 512 blocks of 
T-14. Execution of the second instruction causes the in¬ 
formation on system program unit number 6 to be com¬ 
pared with T-i4 until a sentinel block of W/ZZZZZZZZ is 
detected on 6. 


Compares information on one magnetic tape with informa¬ 
tion on a second magnetic tape by reading both tapes in a 
backward direction. 


L 

Location 

Command 

Address and Remarks 



COMPB 

COMPB 

11>I2. n . c 
ti, t2, sent, c 


The parameters, action, and example for COMPB are the 
same as those of the COMPF control instruction, except 
that the comparison is made in a backward direction. If 
a begin-tape error occurs before the comparison is com¬ 
plete, the result of the comparison up to that point is 
written out according to c. 


Copies information from one magnetic tape to another, 
and then compares the information copied by reading both 
tapes in a backward direction. 


— 

L 

Location 

Command 

Address and Remarks 



COPYCOMP 

COPYCOMP 

n t ^ 

tl, tz, sent, c 
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AIDE 


Parameters 


Action 


Example 


_ti - The symbolic tape from which information is to be 
copied. 

_t2 - The symbolic tape to which information is to be copied, 
n - See COPY. 


sent - See COPY, 
c - See COMPF. 

• is copied toJt 2 . (See Action of COPY.) 

• is compared with t2 in a backward direction. (See 
Action of COMPB.) 

• The tapes are positioned as they were prior to the 
execution of the COPYCOMP function. 


L Location Command Address and Remarks 


COPY 

COPYCOMP 

COMPB 


4, T-14, 512 

6. T-14, ZZZZZZZZ, F 

4, T-14, 512, F 


Explanation: Execution of the first instruction causes 
512 blocks to be copied from system program unit number 
4 onto T-14. Execution of the second instruction causes 
system program unit number 6 to be copied onto T-14 
until a sentinel block of W/ZZZZZZZZ is detected on 6. 
Then 6 will be compared in a backward direction with 
T-14 and the number of blocks that were copied is indi¬ 
cated on the Console Typewriter. Execution of the third 
instruction causes 512 blocks on 4 to be compared in a 
backward direction with the same number of blocks on 
T-14. In both comparison cases, any inequalities will 
be typed on the Console Typewriter. 
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AIDE 


SPACEF 


F ormat 


Parameters 


Action 


Spaces forward over a magnetic tape. 


L 

Location 

Command 

Address and Remarks 

i 



SPACEF 

!• - 


_t - The symbolic tape to be spaced. 


n - See COPY. 

t is spaced n blocks forward. 


SPACEB 


F ormat 


Parameters 

Action 


Spaces backward over a magnetic tape. 


L 

Location 

Command 

Address and Remarks 



SPACEB 

t. n 


Same as SPACEF. 
t is spaced n blocks backw'ard. 


ENDALL 

F ormat 

Action 


Terminates action of the AIDE service routine. 


L 

Location 

Command 

Address and Remarks 



ENDALL 



The AIDE routine is terminated and control is returned 
to 32KSYS via INXTCON. 


ERRORS 


Type - Out 


Print-Out 


AIDE El 
AIDE E2 
AIDE E3 

AIDE E4 


ILLEGAL CONTROL CARD 
PARAMETERS MISSING 
BEGIN-TAPE ERROR--NO SENTINEL OR 
TOO MANY BLOCKS 

MORE THAN 8 CHARACTERS IN SENTINEL 
PARAMETER 
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AIDE 


Error Exit Following detection and indication of an AIDE error, con¬ 

trol is transferred to SYS. lENDJOB. 

AIDE EXAMPLE L Location Command Address and Remarks 


aide $(1) 

REWIND ALPHA, GAMMA, BETA $(2) 

COPY ALPHA, GAMMA, 150 $(3) 

COPYCOMP BETA, GAMMA, 335, F $ (4) 
COMPB ALPHA, GAMMA j 150, F ${5) 

REWIND ALPHA, BETA $(6) 

ENDALL $(7) 


Explanation: Execution of these instructions causes the 

following action to take place: 

1. AIDE is called into operation. 

2. ALPHA, BETA, and GAMMA are rewound. 

3. 150 blocks of information are copied from ALPHA to 
GAMMA. 

4. 335 blocks of information are copied from BETA onto 
GAMMA, and are then compared in a backward direc¬ 
tion. Any differences are typed on the Console Type¬ 
writer. 

5. 150 blocks of information on ALPHA and GAMMA 
(referred to in Step 3) are compared in a backward 
direction. Any differences are typed on the Console 
Typewriter. 

6. Tapes ALPHA and BETA are rewound without lockout. 

7. Control is returned to 32KSYS. 
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ANALYZER 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


PROGRAM TO 
BE ANALYZED 


INPUT-OUTPUT 
SYSTEM 

CONTROL 

INSTRUCTIONS 


Format 


Parameters 


ANALYZER SERVICE ROUTINE 


Prepares a listing of ail references made by a program 

or 3l portion, oi u. 


-k***^'^ 1*^ *v% A rvA r' »• ir 


Any portion or all of memory may be specified. 

The ANALYZER service routine may be called into opera¬ 
tion by the following instruction: 


L Location Command Address and Remarks 


ANALYZER 


The program to be analyzed may be in RPL or ABS format 
and may appear on any magnetic tape except TSYSCR3, 
TSYSOUT or TSYSCR6, It is loaded into memory. An 
ABS program on tape must be preceded by a dummy PMAX 
card, unless the program to be analyzed immediately fol¬ 
lows on TSYSIN . 


ANALYZER uses 32KSYS XORD for all tape operations. 


ANALYZER accepts two control instructions: ANALYZE 
and ENDALL. The instructions are written in standard 
32KSYS control line format. 


L 

Location 

Command 

Address and Remarks 


format 

ANALYZE 

t, id, addr^, addr 2 , addr 3 , 
addr4 


format - Format of the program to be analyzed. 


RPL Indicates RPL format 
ABS Indicates ABS format 

t - The symbolic tape except TSY3CR3, TSYSOUT and 
TSYSCR6 that contains the input program. 

id (OPTIONAL) - The identity of the program to be ana¬ 
lyzed. If omitted, t will be assumed to be positioned 
at the start of the program. 
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ANALYZER 


Action 


ANALYZER 
EXAMPLE t 


OUTPUT 

FORMAT 


addr 1 - The beginning address of the coding to be analyzed. 
addr?, - The ending address of the coding to be analyzed. 
addr '^ - The beginning address of the referenced area. 
addr 4 - The ending address of the referenced area. 

• t is searched for program 

• Each instruction of the program to be analyzed is then 
examined individually from tape to determine: 

1. If its location falls within the range addri-addr2. 

Z, If the memory address which it references falls 
within the range addr 3 - addr 4 . 

3, If the instruction contains a reference to an index 

register or is an index register-modified instruction. 

• All instructions meeting conditions (1) and (2) or (1) 
and (3) are sequenced by referenced location. 

• All processed output is then written onto TSYSOUT 

for printing on the High-Speed Printer in Data Select 0. 

• t is normally positioned following the final block of 
the analyzed program. 

• The next ANALYZER control instruction is requested. 


L 

Location 

Command 

Address and Remarks 


RPL 

ANALYZE 

ALPHA, ALTAC3. 10000, 
22000.0. 77777$ 


Explanation. Execution of this instruction causes a list¬ 
ing of RPL program ALTAC3, located on ALPHA to be 
prepared. The listing will include those references to 
memory locations 0 through 777778 made by program lo¬ 
cations lOOOOg through ZZOOOg, 

The output of the ANALYZER service routine is written 
onto TSYSOUT for off-line printing on the High-Speed 
Printer with Data Select 0. Each page of output con¬ 
sists of a one-line heading statement, a listing of the 
sorted analyzed output, and an ending statement. 
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ANALYZER 


Heading 

Statement 

Ending 

Statement 


REMARKS 


ERRORS 


Error Exit 


The heading statement includes the date, time, page num¬ 
ber and specified parameters. 

The ending statement is normally; END OF ANALYZER. 

If there was too much input data for the ANALYZER rou¬ 
tine to process, the following ending statement will appear; 

PROGRAM EXCEEDED ANALYZER MEMORY CAPACITY 

1. Processing of each ANALYZE instruction is completed 
before the next instruction is executed, 

2. Separate outputs are written for each ANALYZE con¬ 
trol instruction executed. 

3. Programs need not be analyzed in the order they ap¬ 
pear on tape since a complete search (forward and 
backward) is made for each program. 


Type-Out 


Print-Out 


ANAL El 
ANAL E2 
ANAL E3 
ANAL E4 
ANAL E5 
ANAL E6 
ANAL E7 
ANAL E8 


ILLEGAL CONTROL CARD 

TAPE SPECIFIED IS RESERVED BY SYSTEM 

PARAMETER MISSING 

SPECIFIED FORMAT NOT ABS OR RPL 

ILLEGAL RPL SECTION WORD 

ILLEGAL ABS CARD 

CHECKSUM ERROR 

END PARAMETER LESS THAN START 


Following detection and indication of the ANALYZER errr 
ANALYZER searches lor the ENDALL card and thentrane 
fers control to INXTCON. 
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DATA 


DATA SERVICE ROUTINE 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT-OUTPUT 

SYSTEM 


Transfers data required by a user’s program from 
TSYSIN onto a specified tape. At the option of the 
user, the routine may also convert Image Mode input 
to Code Mode output and/or alter card format. 


The DATA service routine may be called into operatiC-n 
by the following instruction: 


L 

Location 

Command 

Address and Remarks 



DATA 



Data uses 32KSYS XORD for all tape operar:o.';s 


CONTROL 

INSTRUCTIONS 


TAPE 


F ormat 


Parameters 


DATA accepts two control instrurtions: TAPE ar.d 
ENDDATA, 


The instructions are written in standard iZKSYS ror-ioi 
line format. 


Specifies the data transfer to be performed by the DATA 
service routine, and must be immediately foxiowed oy 
the data to be transferred. 


L 

Location 

Command 

Address and Remarks 



TAPE 

t, mode . words , cards 


The symbolic tape except TSYSOUI and TSYSTEM 
onto which the data is to be transferred 


mode (OPTIONAL) - The mode of the output data. 


CODE 

Indicates Code Mode, 

Inpiit may t - 

or 

HOLL 

either Code or image 

Mode. 

IMAGE 

Indicates Image Mode 

Input must be 

or 

Image Mode. If mode 

is cm ttf^d 

binary 

input data will be transferred lo t .n 
Code Mode, 10 words per card 12 
cards per block. 




DATA 


words (OPTIONAL) ~ The number (de^c mal/ of words 

tn, hi(^ t -r w T f-; ^ T r fn t h P OlltDUt tdDG. If 

mode 'Is CODE or HOi-i- words may be any number 
from one through 10. 'f mode .s .MAGE or BiNAFO, 
words m -1 y be any numbe; irorn one througn ZG. 

cards (OPTIONAL) - Tnc number idecimaj; of cards 
per block tc be rrarsf-^ r rerl 'o ’’he output tape. 


REMARKS 


The product of words 1 i.rnes a t ds must be equal to or 
les s than 1 Z8 j q . 

1. Cards is required if ■'•ords is specified. 

Z. Blank columns on a card are transcribed onto t as 

zeros if the transfer s in -mage Mode, or as spaces 

(60„) if the transfe: s .n C.ode Mode, 
o 

3. If the number of cards suppu-ed as input data is not 
sufficient to meet '.he cards pei biOck requirement 
for the final block, cards ot al. zeros or spaces 
will be provided for tiarsfer to ^he output tape until 
the final block has Pee . *i 'ec w th the specified 
number of cards par b.ock 

4. The remaimno; words in eai li bioi k. determined by 
1 28 minus V'ords time i ards wu.i contain filler 

c h a r <1 c t e r s ( 3 Z ^ , 

5. If both wo rds and < i ds a re amva^cL input data will 
be transferred ic t as 10 ^ ords per card, IZ cards 
per block if mode is CODE o” HOL-L, ZO words per 

r- ;b 1“'"I S X c S' OP T ’ m ^ ^ IMAGE or 

BINARY 

6. The TAPE coraroi UiS .. ui. lion must be '.he first 
card foiioving the i,aj ici E'’Al.A, 

7. t is not rewound bv the DA LA routine either before 
or after it is used, 

8. Data is transcrioea onto st<ir' ng at the beginning 
of the next block. 
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DATA 


XNDDATA 

Format 

ERRORS 


Error Exit 

DATA EXAMPLE 


Terminatoi the DATA service routine by writing the 
final output buffer block of data onto and causes con¬ 
trol to be returned to 32KSYS. 


L 

Location 

Command 

Address and Remarks 



ENDDATA 



Type-Out 


Print-Out 


DATA El 
DATA E2 

DATA E3 
DATA E4 
DATA E5 

DATA E6 

DATA E7 

DATA E8 

DATA E9 


ILLEGAL CONTROL CARD 

TAPE SPECIFIED IS RESERVED BY 

SYSTEM 

ILLEGAL FORMAT PARAMETER 
INPUT IS NOT IMAGE AS SPECIFIED 
WORDS/CARD NOT SPECIFIED OR 
ILLEGAL 

CARDS/BLOCK NOT SPECIFIED OR 
ILLEGAL 

WORDS/CARD X CARDS/BLOCK 
ILLEGAL 

MORE THAN 8 CHARACTERS IN 
PARAMETER 

PARAMETER IS NOT NUMERIC 


Following the detection and indication of a DATA error, 
control is transferred to lENDJOB. 


— Location Command Address and Remarks 

DATA $] 

TAPE ALPHA, IMAGE, 16,8 $2 

(Data to be transcribed) 

ENDDATA $: 

DATA 

TAPE BETA, CODE, 4, 30 $! 

(Data to be transcribed) 

ENDDATA ,$f 


Explanation: Execution of these instructions causes the 
following action to take place: 

1. DATA is called into operation. 
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DATA 


2. ALPHA is specified as the tape onto which the Image 
Mode data is to be transferred in Image Mode, 16 
words per card, 8 cards per block. 

• The data is processed and transferred as 
de signated. 

3. ENDDATA terminates the service routine. 

4 , The DATA instruction causes return of control to 
the DATA service routine. 

5, BETA is the specified tape onto which the data is 
to be transferred. This transfer is to be in Code 
Mode, four words per card, 30 cards per block. 

• The data is processed and transferred as 
designated. 

6, ENDDATA terminates the service routine. Control 
is returned to 32KSYS. 


14-16 



FLID 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT 

REQUIREMENTS 


INPUT-OUTPUT 

SYSTEM 

CONTROL 

INSTRUCTIONS 


FLID SERVICE ROUTINE 


Finds or Lists the IDentities of RPL, ABS, REL, and 
TAC language programs on tape. 

The FLID service routine may be called into operation 
by the following instruction: 


L 

Location 

Command 

Address and Remarks 



FLID 



Programs not starting at the beginning of a block will 
not be detected by FLID, and will be identified on the 
listing as OTHER, OTHER indicates that a block con¬ 
tains information not identifiable as RPL, ABS, REL, 
or TACL. 

ABS programs must be preceded by a dummy PMAX 
card. 

FLID uses 32KSYS XORD for all tape operations. 


FLID accepts six control instructions, written in 
standard 32KSYS control line format: 


Instruction 

REWIND 

LOCSENT 

SENTINEL 

FIND 

LIST 

ENDALL 


F unction 

Rewinds one or more tapes. 

Locates a specified sentinel blcck. 

Designates an ending sentinel block 
for subsequent FIND or LIST control 
instructions. 

Searches for a specified program. 

Provides a listing of the type, ID, and 
block count of programs on a tape. 

Terminates action of the FLID service 
routine and returns control to 32KSYS. 
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FLID 


SENTINEL 

Format 

Parameter 

Action 

Remarks 

FIND 

F ormat 

Paramete r s 


The functions of LOCSENT and REWIND are described 
in the TAPE HANDLING Section. 

Presets FLID so that subsequent FIND or LIST control 
instructions will be terminated whenever the sentinel 
block indicated by this instruction is encountered. 


L 

Location 

Command 

Address and Remarks 



SENTINEL 

sent 


sent - The sentinel word to be used in locating a sentinel 
block, 


FLID is preset so that the operation of all subsequent 
FIND or LIST instructions - prior to another SENTINEL 
instruction - will be terminated whenever the sentinel 
block designated by sent is encountered. 


If the SENTINEL control instruction is omitted, a 


FIND and LIST operations. 


Searches a tape for a program. 


L 

Location 

Command 

Address and Remarks 



FIND 

t, format, id 


t - The symbolic tape to be searched. 


format - The type of program to be located. 
RPL Indicates an RPL program. 

ABS Indicates an ABS program. 

REL Indicates a REL program. 

TACL Indicates a TAG language program. 
id - The ID of the program to be located. 





FLID 


Action 


Example 


LIS T 


F ormat 


Parameters 


• searched forward for program 

• When is encountered, is positioned at the 
beginning of the program. 

• If a sentinel block of Z's or the configuration 
specified by the SENTINEL control instruction is 
encountered, ^ is searched backwards. If the 
program is still not found, exit will be made to 
IXCONER. 


L Location Command Address and Remarks 


FIND ALPHA, RPL, 

PROGRAMMA $ 


Explanation: Execution of this instruction causes 

ALPHA to be searched for the PPL program PRO¬ 
GRAMMA. After the program is located, ALPHA is 
positioned at the beginning of PROGRAMMA. If a 
designated sentinel or Z block is encountered, the tape 
will be searched backward. If the program is still not 
found, exit will be made to IXCONER. 


a >• z'o c a a r\-f f'Vsfk T 

and block count of programs on the tape. The listing 
may be typed on the Console Typewriter and/or printed 
off-line on the High-Speed Printer. 


L 

Location 

Command 

Address and Remarks 



LIST 

t, format, mode 


- The symbolic tape to be searched. 
format - The type of programs to be listed. 
RPL Indicates RPL programs, 

ABS Indicates ABS programs. 

REL Indicates REL programs. 
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FLID 


Action 


Remarks 


TACL Indicates TAG language programs. 

ALL Indicates all of the above types of programs. 

mode - The type of output for the listing. 

T Indicates TSYSOUT for off-line printing 

on a High-Speed Printer. 

B Indicates TSYSOUT for printing on the High- 
Speed Printer and the Console Typewriter. 

F Indicates the Console Typewriter. 

If the mode po.iameter is omitted, T is assumed. 

is searched for the type of program(s) indicated 
by format. 

. As each of the programs designated by format is 
encountered, its program type, ID and block count 
are typed on the Console Typewriter and/or are 
written on TSYSOUT, for off-line printing. 

The listing action is terminated whenever the 
designated sentinel or a block of Z's is encountered. 

1. In addition to indicating the type, ID and block count 
of each of the programs designated by format, FLID 
lists all sentinels and a count of all blocks from the 
initial position on the tape, up to and including the 
final sentinel block. 

2. If ALL is specified as format, blocks of information 
not recognized as RPL, ABS, REL, or TACL pro¬ 
grams will be listed as + + + + OTHER. 

3. Data which appears in the same format as a sentinel 
block, i. e. , contains 120 similar words, is listed 
as a sentinel but will not stop the listing function, 

4. An RPL program which contains any unrecognizable 
RPL control word will be listed by FLID, but will 
be identified as a BAD RPL. The block containing 
the unrecognizable control word and any blocks 
remaining in the program will be identified as 

+ + + + OTHER. 
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FLID 


5. If any sentinel block is encountered prior to an 
END card in a TACL program, or prior to a 
binary END or JMP card in an ABS or REL pro¬ 
gram, the listing will include: 

• The program type as TACL or BINARY (the 
latter denoting an ABS or REL program), 

• The first eight characters of the program iD, 

• The words NO END (to denote omission of 
the TAG END card or the binary jump card), 
and 

• The block count of the program. 

Example Location Command Address and Remarks 

LIST ALPHA, TACL, B 


ENDALL 


Format 


Explanation: Execution of this instruction causes TACL 
programs and sentinel blocks on ALPHA to be listed 
until the designated sentinel or Z block is encountered. 
The listing plus a total block count of the tape is typed 
on the Console Typewriter and written on TSYSOUT 

Terminates action and returns control to 32;KSYS. 


L 

Location 

Command 

Address and Remarks 



ENDALL 



Action 


FLID is terminated and control is returned to 3ZKSYS. 


ERRORS 


Type -Out 


Print-Out 


FLID El ILLEGAL CONTROL CARD 

FLID E2 ILLEGAL OR NO FORMAT 

SPECIFICATION 

FLID E3 MORE THAN 8 CHARACTERS IN 

SENTINEL PARAMETER 


14-21 




f ijiJL* 


Error Exit Following the detection and indication of a FLID error, 

FLID searches for the ENDALL card, and transfers 
control to INXTCON. 



PLUM 


FUNCTION 

SERVICE 

ROUTINE 

INITIATION 


INPUT-OUTPUT 

SYSTEM 

CONTROL 

INSTRUCTIONS 


PLUM SERVICE ROUTINE 


Creates a new library or updates an old one. 

The PLUM service routine may be called into oper¬ 
ation by the following instruction: 


L 

Location 

Command 

Address and Remarks 



PLUM 



PLUM uses 32KSYS XORD for all reads, writes, and 
other tape movements. 

PLUM accepts the following control instructions written 
in standard 32KSYS control line format; 


Instruction 

F unction 

OLD LIB 

Specifies the tape and the identity of 
the library to be updated. 

NEW LIB 

Specifies the tape and the identity of 

^ A M A I* * 14 1^ W « » 

trx&c w X 1 L./X CL X y • 

GENTAPE 

Specifies the tape containing the 
generator to be added or replaced. 

ADDGEN 

Specifies the identity of the generator 
to be added or replaced. 

ABSOLUTE 

Indicates that absolute binary cards 
are to follow. 

ENDGEN 

Terminates the processing of a 
generator. 

ADDMACRO 

Specifies the name of the macro 
skeleton to be added or replaced. 

ENDMACRO 

Terminates the processing of a macro 
skeleton. 




PLUM 


POSITIONING 
ITEMS IN THE 
LIBRARY 


Instruction 

ADDSUB 

ENDSUB 

ADDERS 

ME 

NEST 

DELETE 

ENDALL 

REWIND 


F ur ■ ^.or. 

Spt-c fits the name of the TAG language 
subrout ne 'o b- ^dded or replaced. 

Termina^^es the processing of a TAG 
language subrout'rie 

Spec f>s the ’-.am<= cf a bmary re- 
ocalabi" subrout re ’o be added or 
replaced 

Denotes rhat the subroutine (TAG 
language or binary relocatable) can 
also be er^eted at the symbolic 
location spee d ed in the address field, 

Sigr ties that; *-he s..broutine (TAG 
language or biurfry relocatable) to be 
added calls upon The subroutine 
spec f.ed -.r *he address field 

De'e*es a ma, ro gerierator, or sub- 
rout .re from the .ibrary, 

Termunt^s he PLUM rout, Tie and 
reTarrs ccrtro. to the SYSTEM /la SYS, 
INXICON 

Re\c rds one or more magn'^t’.c tapes. 


The function of REW ND s as desv r bed ;r the rape 
handling section 


When updat'ing, routines must be prepared for addition 
deletion or replacement lH the nput deck according to 
the order of the corresponding rout-ues on the "old" 
library rape. The reia^ '-e positicring of items to be 
added to the library ;s provided for by the "before" 
option and by the programmer s ordering of items in 
his input deck. 


New generators and subrout,nes are added to the end 
of the new library tape in the order .n which they appear 
unless the "before" opt on ,s used Macros appear after 
the last macro of their spec ified gererator unless the 
"before" option is exerc.sed. 



PLUM 


The "before" option is utilized by placing a semicolon 
after the name of the item to be added and following 
this semicolon with the name of the existing library 
item that the new item is to precede. 

Initialization Instructions 


OLDLIB 


Format 


Parameters 


Action 


Remarks 


Specifies the tape and the identity of the library being 
updated. 


L 

Location 

Command 

Address and Remarks 



OLDLIB 

t;oldid 


The symbolic tape of the library being updated, 
oldid - The identity of the library being updated. 


If oldid and the identity of the library being updated 
are the same, PLUM requests the next control card 
which must be either REWIND or NEWLIB. 


If the identiti es arc not the ssms, 
type-out occurs indicating this condition. To 
continue the PLUM run. the correct library may 
be mounted and ADVANCE depressed. 


1. If * is specified as L TSYSLIB will be updated. 


The OLDLIB control instruction is omitted if a new 
library is being created (a library is not being 
updated). 


3. An OLDLIB control instruction may only be pre¬ 
ceded by a REWIND instruction and may only be 
followed by: 


REWIND 

NEWLIB 
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NEW LIB 


F ormat 


Parameters 


Action 


Remarks 


Specifies the tape and the dert >y of the new library 


L 

Location 

Command 

r“ 

Address and Remarks 



NE W LIB 

w»Cx 


t - The symboLc tape of *he ;.orary be ng created. 


newld ' Eight or fearer alpha”.ume r i characters that 
provide the .dert.ty of the library being created, 

• The identity of the new library .s typed on the 
Console Typewr rer and appears :n the edded 
listing on TSYSOUT 

• PLUM ;S set to p’-oducp th ■ brary on j_ 

1. Only one NEWLjB cortroi instruct. on may be 
issued for each PnUM run 


If ^ library is be ng itpciaxed the OLDLIB instruc 
i;— ^,,=4- cVic. KTFW I ,.R rt;+rnrtion. 

Lit.^XX Xlll-XOL ii-w 1..— -- 


3, Only the following convro. a; s'r-,ct ^ens are 
acceptable to PLUM a’ th s ' .me 


GENTAPE 

ADDSUB 

ADDMACRO 

ADDBRS 

ADDGEN 

DELETE 

REWIND 

endall 
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Updating Instructions 


GENTAPE 


F ormat 


Parameter 


Remarks 


ADDGEN 

F ormat 


Parameters 


Action 


Specifies the tape containing the generator to be added 
or replaced. 


L 

Location 

Command 

Address and Remarks 



GENTAPE 



The symbolic tape containing the generator to be 
added to replaced. 

1. The ADDGEN control card must immediately follow 
the GENTAPE card or LIB E46 will result. 

2. If all generators to be added or replaced during 
the PLUM run are on one tape, then only one GEN¬ 
TAPE control instruction need occur. However, 
each change in the generator tape must be indicated 
by a GENTAPE control instruction. 


Contains the identity of the generator to be added to the 
library tape. 


L 

Location 

nnmmanri 

Address and Remarks 



ADDGEN 

n; id 


n - The number (decimal) of RPL blocks of the generator 
or an asterisk (•■'). 

id - The identity of the generator to be added to replaced. 

• If _ii is a decimal number, PLUM searches the 
generator tape (in a forward direction only) for the 
id specified and then copies that generator onto the 
library according to the block count. 

• If ^ is an asterisk, the generator is added from 
absolute binary cards. The information from the 
cards is converted to RPL form.at and placed on 
the library tape. The id specified becomes the 
identity of the new RPL. 







PLUM 


Remarks 


ABSOLUTE 

Format 


Parameters 

Action 


Remarks 


1. If n IS an asterisk, tne cuntiox 

tion is meaningless and need not occur. 

Z. If n is an asterisk, and less than 16 characters are 
specified as the id, the remaining characters of Jd 
(up to 16) are space filled. 

3. The name and information cards which follow an 
ADDGEN card have the same meaning and format 
whether ji is an asterisk or a block count. 

4. If n is an asterisk, the ABSOLUTE control instruc¬ 
tion must appear immediately following the last name 
and information card. 

5. If n_i8 a block count, the ENDGEN control instruc¬ 
tion must appear immediately following the last 
name and information card. 

6. A macro generator differs from the normal generator 
in that a macro generator can have only one name. 

7. A macro generator is added, replaced, or deleted 
in the same manner as a normal generator. 

8. When a macro generator is replaced, the macros 
associated with it are not changed except as specified 
by subsequent control instructions. 


Indicates that absolute binary cards are to follow. 


L 

Location 

Command 

Address and Remarks 


- - ■ 

ABSOLUTE 

__j 

1 


None. 

• Sets PLUM to convert the subsequent absolute 
binary cards to form the generator RPL, 

1. The control card is only required when the ADDGEN 
card contains an asterisk as its first parameter in 
the Address and Remarks field. 

2. The next acceptable control card is ENDGEN. 
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ENDGEN 

Format 


Parameters 

Action 


Remarks 


Terminates the processing of a generator 


L 

Location 

Command 

Address and Remarks 



ENDGEN 



None. 


• Terminates generator-processing functions for 
current generator, 

• Gets the next PLUM control instruction. 


Only the following control instructions are acceptable: 

GENTAPE 

ADDMACRO 

ADDSUB 

ADDERS 

ADDGEN 

DELETE 

REWIND 

ENDALL 


The following control cards will add a three name 
generator six blocks long to the library, from 
TSYSCR4: 


Example One: 

L Location Command 
GENTAPE 
ADDGEN 


ENDGEN 


Address and Remarks 

TSYSCR4 

6;GEN$ 

FIRSTGEN 

J;3 

SECNAME 

N;79 

THR NAME 
J:l 


Explanation 

Symbolic Tape containing 
the generator. 

Number of RPL blocks to 
be added; identity of 
generator is GEN, 

Multi-name of generator. 
Generator name produces 
a jump; sort # of 3. 
Multi-name of generator. 
Generator name produces 
no jump; sort # of 79. 
Multi-name of generator. 
Generator name produces 
a jump; sort # of 1. 
Indicates end of name and 
information cards for 
GEN. 




PLUM 


Example Two: 

L Location 


ADDMACRO 

Format 

Parameter 

Action 

Remarks 


The following control cards w l. add a get e rat or froiii 
absolute binary cards before the rou< re, PLUMRTN. 

Command Address ard Remarks Explanation 


ADDGEN -ZRPLGEN 

GENABS; RTN 

N 7 


absolute 



ENDGEN 


Gereraioi iS to be added 
from abs b.rary cards 
\r of gere'-ato" s 

..RP-jCENZik^— -^ 

N ,m= of genera’oi :o be 
add“d before RTN 
, ' ' efo : e" op or.) 

Gar =-r^"or name produces 
r ^ ucnp sorr ff of 7, 
d a es hat absolute 
b.raiy cards foiiov'' 

B.r aiy cards o be con¬ 
verted tc RPL- The last 
; cird must be a b.nary 
jc.mD c ard 

rrdica es the end of r ame 
ar d .rifo»-ma 'on cards for 
2RPLGEN A-^A. 

mdA. .'c to be added or replaced- 


Specifies the name of 'he 


L 

Lov at Ion 

C ommar,d 

Address arid Remarks 



ADDMACRO 

name 



name 8 or fewer arpharcme' i characters that comprise 
the name of th- mac 'c 

The m.-icro vv 'i oe added a .1'- e :■ d of the string of 
macros wh ch fi^licjo, 1 ^*=- ge er^'oi sacc f. d, un ess the 
"before option .s used, if r -.ir.- ;.i«ady exists on 
oldid, a repiacement oc curs 

1, The macros immedi^' -ly fo. cw the mat ro generator 
with which they are assoc ated 

2. A macro generator may rw lude 1 Oi: o macros. 





PLUM 


ENDMACRO 

F ormat 


Terminates the processing of a macro. 


L 

Location 

Command 

Address and Remarks 



ENDMACRO 



Parameters 

Action 


Remarks 


Example one: 


L Location 


None. 

• Terminates macro-processing functions for current 
macro. 

• Gets the next PLUM control instruction. 

Refer to remarks of ENDGEN card for acceptable control 
instructions. 

The control cards to add a macro would appear as 
follows: 

Command Address and Remarks Explanation 


ADDMARCO TWOMAC 

MACGEN 

R;3 



ENDMACRO 


Name of macro skeleton m 
be added 

Name of macro generator 
Must start on right 3 ha,l 
words in length (afcsr corn ■ 
pilation). 

Macro skeleton coding 


Example Two: To add a macro using the "before" option, the control 

cards would appear as follows; 


L Location Command Address and Remarks Explanation 


ADDMACRO ONEAMAC;TWOMAC 

MACGEN 

L;2 


ONEAMAC to be added before 
TWOMAC 

Name of macro generator 
Must start on left; 2 half¬ 
words in length (after com¬ 
pilation) . 
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ADDSUB 

Format 

Parameter 

Action 

Remarks 


ENDSUB 

F ormat 

Parameters 

Action 


Specifies the name of the TAC language subroutine to 
be added or replaced. 


L 

Location 

Command 

Address and Remarks 



ADDSUB 

_ 

name 



name - Eight or fewer alphanumeric characters that 
comprise the name of the TACL subroutine. 

The subroutine will be added at the end of the library 
unless the "before" option is used. If name already 
exists on oldid, a replacement occurs. 

1. Subroutines added with the ADDSUB control instruc 
tion must be terminated by an ENDSUB control 
instruction, 

Z. The language of the subroutine to be added is 
assumed to be TACL, 

3, Binary relocatable routines may be included if 
preceded by, first, a BITSBITSBITSBITS card 
(see Example two, for format), and then by a 
binary relocatable PMAX card. 

4. A TACLTACLTACLTAC L card (see Example Two. 
for format) must be used to return to TACL mode. 


Terminates the processing of a TAC language sub¬ 
routine . 


L 

Location 

' ------ 1 

Command 

Address and Remarks 



ENDSUB 



None, 

• Terminates processing of the TACL subroutine. 

• Gets the next PLUM control card 
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Remarks 


ADDERS 


Format 


Paramete r 


Action 


Remarks 


ME 


1. The ENDSUB control instruction is recognized 
only when PLUM is in TACL mode (see remarks 
under ADDSUB). 

2. Refer to remarks under ENDGEN for acceptable 
control cards at this time. 


Specifies the name of a binary relocatable subroutine 
to be added or replaced. 


L 

Location 

Command 

Address and Remarks 



ADDBRS 

name 


iLame - Eight or fewer alphanumeric characters that 
comprise the name of the REL subroutine. 


The indicated subroutine will be added at the end of the 
library, unless the "before' option is used. If name 
already exists on oldid , a replacement occurs. 


1. Subroutines added with ADD3RS control instruc- 

tion arf* f r TTi i n a 

card. 


2. The language of the subroutine to be added is as¬ 
sumed to be REL, and these routines must be 
preceded by a binary relocatable PMAX card, 

3. TAG language routines may be included if pre¬ 
ceded by a TACLTACLTACLTACL card (see 
Example Two, for format), 

4. A BITSBITSBiTSBiTS card must be used to return 
to REL mode. 

Refer to remarks under ENDGEN for acceptable 
control cards at this time. 


Denotes that the .subroutine (TACL or REL) can also 
be entered at the symbolic location specified in the 
address field. 
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Format 

Parameter 

NEST 

Format 

Parameter 

Remarks 
Example One 
L Location 


L 

Location 

Command 

Address and Remarks 



ME 

symb 


symb - Eight or fewer alphanumeric characters that 
comprise the multi-entrance of the subroutine. 


Indicates that the TACL or REL subroutine to be 
added calls upon the subroutine specified in the 
address field. 


L 

Location 

Command 

Address and Remarks 



NEST 

name 


name - Eight or fewer alphanumeric characters that 
comprise the name Of the nested subroutine. 

All ME cards must precede NEST cards. 

To add a REL subroutine; 


Command Address & Remarks 


Explanation 


ADDERS ALPHA 

ME ABC 

NEST DEF 

(PMAX card) 


(REL END card) 


Name of subroutine 
Denotes that ABC is another 
entrance to ALPHA 
Denotes that ALPHA calls 
on subroutine DEF 
Binary relocatable routine 
preceded by a PMAX card 
and terminated by an END 
card. When PLUM recog¬ 
nizes the binary relocatable 
END card, the action of 
the ADDERS instruction is 
terminated. 

Terminates processing 
of subroutine. 
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Example Two 
L Location 


B ITSBITS 

T ACLTACL 

DELETE 

Format 

Parameter 

Action 

Remarks 


ENDALL 


To add a mixed TACL, REL, TACL subroutine: 


Command Address and Remarks Explanation 


ADDSUB BETA 

ME TUV 

NEST WXY 

NAME BETA 


Name of subroutine 
Multi entrance 
Nested subroutine 


TAC language cards 


BITSBITS 

Binary relocatable cards 

___________ preceded by a PMAX 

----------- card 

TACLTACL 


___________ TAC language cards 

ENDSUB 


Deletes a generator, macro or subroutine from the 
library. 


L 

Location 

Command 

Address and Remarks 



DELETE 

name 

L.. 


name - Eight or fewer alphanumeric characters 

specifying the name of the routine to be deleted. 

name is deleted from the library. 

1. To delete a generator and its multiple names, from 
the library tape, all names must be deleted, 

2. Since a macro generator can have only one name, 
the generator and all its macros are deleted by 
specifying the name of the macro generator , 

3. Refer to remarks of ENDGEN card for acceptable 
control cards at this time. 

Wrapup Instruction 


Terminates the PLUM routine and returns control to 
32KSYS. 
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L 

Location 

Command 

Address and Remarks 



ENDALL 



Parameters 

None 

Action 

• 

An edited listing is produced on TSYSOUT for the 
High-Speed Printer. 


• 

A Console Typewriter typeout indicates the number 
of blocks of the new library (excluding the sentinel). 


• 

Tapes used by PLUM are rewound. 


• 

Return is made to 32KSYS via INXTCON. 


CONSOLE 

Message 

Explanation 

Action 

TYPEWRITER 

NORMAL 

NEW ID 

IDof library being created. 

None 

TYPE-OUTS 

newid 

Number of blocks of new 



nnnnn 

library. 



CONSOLE 

TYPEWRITER 

Me ssage 

Explanation 

Action 

ERROR 

NOT LIB 

Tape to be updated is not 

Program halts 

TYPE-OUTS 


a library tape. 

at M/77777. 
Mount tape 
and depress 
ADVANCE. 

This can be 
used only 

once. 


NOT ID 

The ID of the tape to be 

Program halts 


oldid^ oldid ^ 

updated does not match 
that specified on the 
OLDLIB control card, 
oldid 1 is the ID of the 
old library and oldid? 
is the ID on the control 
card. 

at M/77777. 
Mount new tape 
and depress 
ADVANCE. 

This option 
can be used 
only once. 


PLUMDMP 

Computer error: dropped 
or picked up a bit ac¬ 
cording to the mask in 
the Q register. 

Program 
halts at 
M/33333. 
Restart job. 
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CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 

(Continued) 


Message 


Explanation 


Action 


LIB Ej^ 


PLUM recognized an 
illegal control card. 
n indicates the type of 
error and is explained 
below. 


None required. 
Control is 
transferred to 
SYS. IENDJOB. 


ERROR 

PRINTOUTS 


If PLUM detects an error, the card in error along with 
the LIB En is printed on the system output tape, TSYS- 
OUT is edited for printing on the High-Speed Printer , 


Number 

1 

2 


Explanation 


The initialization control cards are il¬ 
legal. 


While creating a new library, a DELETE 
control card was detected by PLUM. 


3 While creating a new library, an ADDCaRD 

with the "before" option was detected by 
PLUM, 


4 The generator specified to be added to rhe 
library tape is not on tape specified In 
parameter of GENTAPE control 

5 OLD LIB is not a library tape. 

(1 st word of 1 St block was rot ' LiBRAR Y, ") 

6 A semicolon was missing from a control 
card, e.g., J, 3 on a generator control 
card which specifies a jump and sort 
number. 

7 When operating on an ADDGEN "before ' 
PLUM did not detect the routine which 
was specified by the "before" option 


8 The N or J, which specifies a jump or 

no jump on a generator control card, 
was missing. 
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ERROR 

PRINTOUTS 

(Continued) 


Number Explanation 

9 When updating an old library, the routine 

specified in a DELETE control card was not 
detected. 

10 When operating on an ADDMACRO "before, " 
PLUM did not detect the macro which was 
specified by the "before" option. 

11 The name specified by the "before" option 
on an ADDMACRO control card was not a 
macro. 


12 While creating a new library, a macro has 
been added out of the sequence of its macro 
generator. 

13 While updating an old library, the macro 
generator for an ADDMACRO was not de¬ 
tected. 

14 When operating on an ADDSUB "before", 
PLUM did not detect the routine which was 
specified by the "before" option. 

15 When operating on an ADDERS "before", 
PLUM did not detect the routine which was 
specified by the "before" option. 

16 The ID of the library oeing updated does not 
agree with ici ol the OLDLIB control card, 

17 A checksum error was detected on a binary 
relocatable card. 


18 Legal control cards at this time are: 
ADDSUB, ADDERS. ADDMACRO, ADDGEN, 
DELETE, REWIND, or ENDALL. 

19 Working on ADDSUB. Legal control cards 
at this time are; ME, NEST, or NAME. 

20 Working on ADDSUB. Legal control cards 
at this time are: NEST, or NAME. 
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ERROR 

PRINTOUTS 

Number 

Explanation 

(Continued) 

21 

Working on ADDSUB. Legal control cards 
at this time are: ENDSUB, or NAME. 


22 

Working on ADDBRS, Legal control cards 
at this time are: ME, NEST, or PMAX 
card. 


23 

Working on ADDBRS. Legal control cards 
are: NEST or PMAX card. 


24 

Working on ADDBRS. Legal control cards 
are: Binary relocatable end program card, 
ENDSUB, or NAME, 


25 

Working on ADDGEN. Legal card: One 
which specifies the name of a generator In 
the address field. 


26 

Working on ADDGEN. Legal control cards 
are: ENDGEN or a card containing the nam^ 
of generator in address field. 


27 

Working on ADDGEN. Legal card: Jump 
or no Jump; iSort number in address fieldc 


28 

Working on ADDMACRO: Legal card” 

Name of generator, to which macro is to 
be added, in the address field. 


29 

Working on ADDMACRO. Legal card: Left 
right, or either; number of lines after 
compilation in the address field. 


30 

Working on ADDMACRO, Legal control 
card: ENDMACRO 


31 

The Table of Contents is too large. 


32 

Illegal binary relocatable subroutine card. 


33 

While adding a generator to an old library 
PLUM detected a subroutine or macro with 
the same name. 



PLUM 


ERROR 

PRINTOUTS 

(Continued) 


Number 


34 


35 


36 


37 


38 


39 


40 


41 


42 


43 


Explanation 

While adding a TACL or a binary relocatable 
to an old library, PLUM detected a macro 
or generator with the same name. 

While adding a macro to an old library, 
PLUM detected that the generator specified 
was not a macro generator. 

The "before" item specified in an ADDGEN, 
ADDSUB, or ADDERS control card is a 
macro, or the second or later name of a 
multi-name generator. 

The R, L, or E, which specifies right, 
left, or either on a macro input card, was 
missing. 

Working on ADDGEN in absolute binary. 
Legal cont'"ol cards at this time are: 
ABSOLUTE or spaces in Command Field. 

Working on ADDGEN in absolute binary. 
PLUM encountered more than 75 names in 
a multi-name generator. 

Working on ADDGEN in absolute binary. 

The only legal card immediately following 
an ABSOLUTE control card is an absolute 
binary card. 

Working on ADDGEN in absolute binary. 

The only legal cards at this time are: an 
absolute binary card or a binary jump card. 

Working on ADDGEN in absolute binary. 

The only legal cards immediately following 
a binary jump card are: ENDGEN or an 
absolute binary card. 

A checksum error was detected on an 
absolute binary card. (This error may also 
indicate that the card is not an absolute 
binary card but appears to be one.) 
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ERROR 

PRINTOUTS 

(Continued) 


Number Explanation 

44 GENTAPE parameter illegal. 

46 Illegal control card following a GENTAPE 

card. 


47 No GENTAPE command preceded an ADDGEN 
control card. Generator is added from a 
tape not used before. 

48 Illegal parameter (minus sign) found on 
control card. 


Error Exit 


Following detection and indication of a PLUM error, 
control is transferred to SYS. lENDJOB. 
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RPLC 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT-OUPUT 

SYSTEM 


CONTROL 

INSTRUCTIONS 


RPLC SERVICE ROUTINE 

Revises the contents of a tape by adding, deleting, or 
correcting RPL programs. 

The RPLC service routine may be called into operation by 
the following instruction: 


L 

Location 

Command 

Address and Remarks 



RPLC 



32KSYS XORD is used for all tape operations. 


RPLC accepts the following written in standard 32KSYS 
control line format: 


Inst ruction 
NEWTAPE 

REWIND 

COPY 

COPYTIL 

SKIPTIL 

DELETE 

ADD 

WRTSENT 


F unction 


Specifies the tape onto which the up¬ 
dated information is to be written. 

Rewinds tapes. 

Transfers information to the output 
tape specified by NEWTAPE. 

Transfers information until a desig¬ 
nated RPL program is encountered. 

Bypasses all information until a 
designated RPL program is encoun¬ 
tered. 

Copies all information until a desig¬ 
nated RPL program is encountered, 
and then bypasses the program. 

Adds a program in RPL format, 

Writes a sentinel block on tape. 
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RPLC 


CONTROL 

INSTRUCTIONS 

(Continued) 


NEWTAPE 

Format 

Remarks 

COPY 

Format 


Instruction 


Function 


LOCSENT 

CORRECT 

IDCHANGE 


INDEX 

END 

ENDALL 


Locates a sentinel block on tape. 

Makes corrections to an RPL, and 
transfers it to the output tape. 

Copies all information on an input tape 
until a designated RPL program is en-- 
countered, makes corrections to that 
program and transfers it to the output 
tape IDCHANGE also changes the RPL 
ID. 

Writes index block(s) on NEWT APE 
that contain ID's of all programs cn 
NEWTAPE to this point. 

Terminates individual program cor 
rection. 

Terminates the RPLC routine and re ¬ 
turns control to SYS. 


The functions of REWIND. LOCSENT, and WRTSENT are 
as described in TAPE HANDLING. 

Specifies the magnetic tape onto which the updated in¬ 
formation is to be placed. 


L 

Loc ation 

Command 

Address and Remarks 



NEWTAPE 

L 


t - The symbolic tape (except TSYSTEM, TSYSOUT, and 
TSYSIN) which is to be the output tape. 


NEWTAPE must precede all other control instructions 
except REWIND. 

Copies all information from an input tape onto the output 
tape. 


L 

Location 

Command 

Address and Remarks 



COPY 

t, sent 
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RPLC 


Parameter! 


Action 


Example 


t - The symbolic tape whose contents are to be copied. 

sent (OPTIONAL) - The sentinel word to be used in lo¬ 
cating a sentinel block, 

• All information on t beginning at the point where_t is 
currently positioned, is copied onto the output tape 
until a sentinel block of sent is encountered. 

• If sent is omitted, a sentinel block of Z's will ter¬ 
minate the copy action. 

• When the sentinel block is encountered, _t is positioned 
immediately following the sentinel block. 

L Location Command Address and Remarks 


COPY ALPHA, AAAAAAAA 


Explanation: Execution of this instruction causes all in 
formation on Tape ALPHA to be copied onto the output 
tape until a sentinel block of A's is encountered. 


COPYTIL 


Format 


Parameters 


Action 


Remarks 


Copies information from an input tape onto the output tape 
until a specified RPL program is encountered. 


L 

Location 

Command 

Address and Remarks 



COPYTIL 

t, id 


t - The symbolic tape whose contents are to be copied. 

M (OPTIONAL) - The ID of the RPL program to be lo¬ 
cated. Omitting this parameter is equivalent to speci¬ 
fying the ID of the next RPL on the tape. 

• All information on t, beginning where t is positioned, 
is copied onto the output tape until RPL program id 
is encountered. 

• Upon completion of the copy, t is positioned at the 
start of the RPL program id. 

The RPL Program id is not copied. 
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RPLC 


SKIPTIL 

Format 

Parameters 

Action 


DELETE 

Format 

Parameters 

Action 


ADD 

Format 


Bypasses all information on an input tape until a specified 
RPL program is encountered. 


L 

Location 

Command 

Address and Remarks 



SKIPTIL 

t, id 


Same as COPYTIL. 

a All information on^, from where _t is positioned, is 

passed over until the RPL program ^ is encountered. 

s When id is located, _t is positioned at the beginning of 
that program. 


Copies all information from an input tape onto the output 
tape until a specified RPL program is located. That pro¬ 
gram is then bypassed. 


L 

Location 

Command 

Address and Remarks 



DELETE 

t, id 


Same as COPYTIL. 

• All information on t, from where t is currently posi- 
tioned, is copied onto the output tape until the RPL 
program id is encountered. 

• id is bypassed and t is positioned at the end of the pro¬ 
gram or immediately following the sentinel if one were 
encountered. 


Bypasses all information on an input tape until a specified 
RPL program is located. That program is then copied 
onto the output tape. 


L 

Location 

Command 

Address and Remarks 



ADD 

t, id 


14-45 






RPLC 


Parameters 


Action 


CORRECT 


Format 


Paramete rs 
Action 


t - The symbolic tape on which the RPL program is con¬ 
tained, or an asterisk (=<') which indicates that the 
ABS deck which follows is to be added to the output 

LdpC ill r\ i AJ 

id - The identity of the RPL to be added. 

• If t is a symbolic tape, information on_t, from where 
t is currently positioned, is bypassed until the RPL 
program id is encountered. The program is then 
copied to the output tape, t is positioned at the end of 
the program added or immediately following the senti¬ 
nel if one were encountered. 

• If t i s an asterisk { '), the information from the ABS 
cal-ds which immediately follow, is converted to RPL 
format and copied to the output tape. 

1. If t is an id is an optional parameter, if a PMAX 
card precedes the ABS deck. 

2. If both id and a PMAX card are present, the identity 
of the RPL IS taken from the PMAX card. 

Copies all information from an input tape onto the output 
tape until a specified RPL program is located. Correc¬ 
tions are made to that program and it is copied onto the 
output tape. 


L 

Location 

Command 

Address and Remarks 



CORRECT 

t, id 


Same as ADD. 


• If t is a symbolic tape, information on t from where t 
is currently positioned, is copied onto the output tape 
until the RPL program id is encountered. 

• id is copied onto the output tape, and the corrections 
(which follow the CORRECT instruction) are added as 
separate RPL sections prior to the end of the RPL. 

• t is positioned at the end of the program or immedi¬ 
ately following a sentinel if one were encountered. 
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RPLC 


Corrections 


Format 


Parameters 


Remarks 


• If t is an asterisk see Action under ADD. In 

addition, the corrections (which follow the ABS END 
card) are added as separate RPL sections prior to 
the end of the RPL. 

Corrections to an RPL program appear immediately after 
the CORRECT or IDCHANGE control instructions, except 
where t in the CORRECT instruction is an asterisk (*). 


L 

Location 

Command 

Address and Remarks 

P 

ml 

instr 

m2 


p - An alphabetic character, L or R, which indicates 
whether the change is to start in the left or right 
half of the word specified by mj. If omitted, L is 
assumed. 

L Specifies the left instruction 

R Specifies the right instruction 

m 1 - An octal address, written in the Location field, which 
indicates the location of the first word to be changed. 

If consecutive instructions or locations are to be cor¬ 
rected, the label and location of only the first need be 
specified. 

instr - The new word constant (W/), octal constant (O/), 
or command part of a new instruction. Word con¬ 
stants may be eight or fewer alphanumeric characters. 
If fewer than eight characters are used, the constant 
is assumed to be left-justified and right-filled with 
spaces. Octal constants must contain exactly 16 digits. 
The command part of a new instruction is written as a 
standard TAG mnemonic. 

r^2 ~ An octal address. If indexed, the form must be; 
val , i where val is an octal number from 0-7777 and 
i is a number from 0-7. 

Only one correction per card is permitted. 
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RPLC 


END 


Format 


Parameters 

Remarks 


Terminates the individual program correction. 


L 

Location 

— 

Command 

Address and Remarks 



— 

END 



None. 

An END instruction must be used to terminate the correc¬ 
tion procedure whether the t parameter of the CORRECT 
instruction is a symbolic tape or an asterisk (-!*). 


IDCHANGE 


F ormat 


Parameters 


Action 


Remarks 


Example 


Same as CORRECT. In addition, the identity of the cor¬ 
rected RPL is changed. 


L 

Location 

Command 

Address and Remarks 



IDCHANGE 

t, id 


t - The symbolic tape containing the RPL program, 
id - The identity of the RPL to be corrected. 

• Information on t, from where t is positioned, is copied 
onto the output tape until the RPL program id is en¬ 
countered. 

• The Action for the CORRECT instruction applies, ex¬ 
cept that the ID of the corrected RPL program has 
been changed as specified by the first correction card. 

The first correction following the IDCHANGE instruction 
must be the new ID. An I is written in the Label column 
and the new ID is written in the Command and Address and 
Remarks fields. 

L Location Command Address and Remarks 

IDCHANGE ALPHA, PROGRAMlS 
I PROGRAM2 

END 
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RPLC 


INDEX 

Format 

PARAMETERS 

ACTION 


REMARKS 


ENDALL 

Format 


Explanation; Execution of these instructions causes all 
information on Tape ALPHA to be copied onto the output 
tape until RPL program PROGRAMl is encountered. Whei 
located, the old ID is replaced by PROGRAM2 and is copie 
onto the output tape. If there had been any other correc¬ 
tions, they would have been treated in the same manner as 
effected by the CORRECT control instruction. RPLC then 
requests its next control instruction. 


Writes an index block(s) onto the output tape that contains 
the id's of all RPL programs already existing on NEWTA.P 


L 

Location 

Command 

Address and Reniaiks'~j 



INDEX 

1 


None. 

• The word **'!-INDEX is placed in Words 0 and 1 of 
first index block. Succeeding blocks, if any, are no; 
identified with = INDEIX. 

• ID's of all RPL's on me autput tape are transferred to 
the output block following the ' ""INDEX identification 

• When all ID's have been transferred, a sentinel word 
of 48/1's is placed in the output block following the 
last ID. 

1. Index blocks that already exist on an input RPL tape 
are updated by RPLC when transferred to the output 
tape. 

2. Index blocks can only be deleted by using RPLC con¬ 
trol instructions to position the input tape around the 
index blocks. 


Terminates the action of the RPLC service routine and re 
turns control to 32KSYS. 


L 

Location 

Command 

Address and Remarks 



ENDALL 

li st, sent, pos 
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RPLC 


PARAMETERS 


ACTION 


RPLC 

SERVICE 

ROUTINE 

EXAMPLE 


list (OPTIONAL) - Causes a list of the ID's of all RPL pro¬ 
grams transferred to the output tape to be edited and 
written on TSYSOUT, 

sent (OPTIONAL) - The sentinel word to be used in writing 
the sentinel blocks. 

pos (OPTIONAL) - An alphabetic character that specifies 
the position of the output tape. If the parameter is 
omitted, the tape is positioned after the first sentinel 
block. 

L Specifies that the output tape is to be rewound 
with lockout. 

R Specifies that the output tape is to be rewound. 

• Two sentinel blocks of Z's or the configuration speci¬ 
fied by sent are written onto the output tape. 

• If LIST is specified, a listing of the ID's of all RPL 
programs transferred to the output tape is edited and 
written on TSYSOUT. If list is omitted, no listing 
will be processed. 

• The output tape is positioned according to pos. 

• Control is returned to 32KSYS via INXTCON. 


I^ 

Location 

Command 

Address and Remarks 



RPLC 


(1) 



REWIND 

NEWRPL, TAPE 10, 





TAPE 11, TAPE 12 

(2) 



NEWTAPE 

NEWRPL 

(3) 



COPYTIL 

TAPE 10, HOMER$ 

(4) 



ADD 

TAPE 11, ALPHA$ 

(5) 



CORRECT 

TAPE 12,GAMMA$ 

(6) 

L 

14063 

TMA 

11075 

(7) 

R 

15321 

TDXL 

4. 5 

(8) 



END 


(9) 



COPY 

TAPE 10, AAAAAAAA 

(10) 



ENDALL 

LIST 

(11) 
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RPLC 


Explanation: Execution of these instructions causes the 

following action to take place: 

1. RPLC is called into operation 

2. Tapes NEWRPL, TAPE 10, TAPE 11, and TAPE 12 
are rewound. 

3. Tape NEWRPL is specified as the final output tape. 

4. All information on TAPE 10 is copied onto tape 
NEWRPL until RPL program HOMER is encountered. 
Tape remains positioned at the beginning of program 

HOMER. 

5. All information on TAPE 11 is bypassed until RPL 
program ALPHA is encountered. ALPHA is copied 
onto NEWRPL. Tape 11 remains positioned at the 
beginning of the next block past ALPHA. 

6. All information on TAPE 12 is copied onto NEWRPL 
until RPL program GAMMA is encountered. 

7. GAMMA is copied onto NEWRPL and the TMA in¬ 
struction is inserted as a separate RPL sectio.i at 
the end of GAMMA. At load time it will overlay 
location 14063Lg of program GAMMA. 

8. The TDXL instruction is inserted as a separate RPL 
section following the Pv.PL section referred to in step 
7. At load time, it will overlay location 15321Rg of 
program GAMMA. 

9. The END instruction signifies the end of correction.s. 

10. All information on TAPE 10 beginning with RPL pro¬ 
gram HOMER, IS copied onto NEWRPL, until a 
sentinel block of A's is encountered. 

11. Two sentinel blocks of Z's are written on NEWRLL, 
and a list of the ID’s of all RPL programs transferred 
to the output tape is edited and written on TSYSOUT. 
The output tape is positioned after the first sentinel 
block, and control is returned to 32KSYS via INXTCON. 
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RPLC 


ERRORS 


Error Exit 


Type -Out 

RPLC El 
RPLC E2 

RPLC E3 
RPLC E4 

RPLC E5 

RPLC E6 

RPLC E7 

RPLC E8 

RPLC E9 

RPLC ElO 
RPLC Ell 
RPLC E12 


Print-Out 


ILLEGAL CONTROL CARD 
TAPE SPECIFIED IS NEWTAPE OR IS 
A RESERVED SYSTEM TAPE 
NEWTAPE HAS NOT BEEN SPECIFIED 
SENTINEL BLOCK PREVENTED COM¬ 
PLETION OF FUNCTION i 

THE CARD FOLLOWING "IDCHANGE" 
CONTROL IS NOT AN "I" CARD 
RPLC IS NOT GOOD - ILLEGAL SEC¬ 
TION WORD 

ILLEGAL CORRECTION CARD 
(CARD IGNORED) 

MORE THAN 8 CHARACTERS IN 
SENTINEL PARAMETER 
ID IS MISSING ON ADDITION OR COR¬ 
RECTION OF AN ABS DECK 
CHECKSUM ERROR ON ABS CARD 
ILLEGAL BINARY CARD IN ABS DECK 
ILLEGAL PARAMETER IN ENDALL 
CARD 


Following detection and indication of an RPLC error, con¬ 
trol is transferred to SYS. lENDJOB. 
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TACSERV 


TACSfiRV SERVICE ROUTINE 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT 

REQUIREMENTS 


INPUT-OUTPUT 
SYSTEM 


CONTROL 

INSTRUCTIONS 


Copies TAG language information from one magnetic tape 
to another, adding, deleting, or replacing cards or pro¬ 
grams during the process. 

The TACSERV service routine may be called by the follow¬ 
ing instruction: 


L 

Location 

Command 

Address and Remarks 



TACSERV 



Information on the input tape must be in TAG language 
format in Code Mode, 10 words per card, 12 cards per 
block. Each program on the tape must contain an I card 
as the first card of the first block, and an END card as 
the final card of the program. An I card contains an I m 
Column 9, v/hile Columns 10 through 16 are blank. 

TACSERV uses 32KSYS XORD for all reads, writeS; and 
tape movements. 

TACSERV accepts 22 control instructions, written in 
standard 32KSyS control line format. The instructions 
are grouped into two classes - Class I and Class If - pre 
ceded by a mandatory initialization instruction, NEWTAPE. 
Class I instructions provide program-by-program and 
tape movement operations, while Class II instructions 
provide card-by-card operations for revision of TAC lan¬ 
guage programs. Class II is initiated by the CORRECT 
instruction and is usually terminated by the ENDPROG 
instruction. 

The 22 TACSERV control instructions are; 

Instruction Class Function 

NEWTAPE I Initiation control card which 

assigns the output tape, 

ADDPROG I Transfers a specified pro¬ 

gram without change from an 
input to the output tape. 
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Instruction 


Class 


COPY I 


COPYTIL I 


CORRECT I 


DELPROG I 

ENDALL I 

LOCATE I 

LOCSENT I 

REWIND I 

REWINDLO I 

SENTINEL I 

WRTSENT I 


Function 


Transfers information with¬ 
out change to the output tape 
until a specified sentinel 
block is encountered. 

Transfers information with¬ 
out change to the output tape 
until a specified program is 
encountered. 

Transfers information with¬ 
out change to the output tape 
until a specified program is 
encountered, and sets 
TACSERV to the Class II mode 
(individual program correc¬ 
tions). Program correction 
instructions (Class II) must 
follow. 

Deletes a specified program 
from an input tape. 

Terminates the TACSERV 
routine and returns control to 
32KSYS. 

Searches for a specified pro¬ 
gram on an input tape. 

Searches for a specified 
sentinel block on an input 
tape. 

Rewinds one or more magne¬ 
tic tapes. 

Rewinds with lockout one or 
more magnetic tapes. 

Designates an ending sentinel 
block. 

Writes a sentinel block on a 
specified tape. 



TACSERV 


The functions of REWIND, 
WRTSENT are as describe 
TION. 

REWINDLO, LOCSENT, and 
d in TAPE HANDLING SEC- 

Instruction 

Class 

Function 

ADD 

II 

Adds one or more cards to a 

program. 

DELETE 

II 

Deletes one or more c:ards 
from a program. 

DELADD 

II 

Deletes and adds cards. 

ENDPROG 

II 

Terminates individual pro¬ 
gram corrections, and resi : 
TACSERV to Glass I mode. 

LOCSEQ 

II 

Sets TACSERV to scare!: tor 
cards by sequence number. 

LOCFLAD 

II 

Sets TACSERV to search for 
cards by symbolic address. 

NOSEQ 

II 

Halts assignment ol new se¬ 
quence numbers within a pro 


gram. 

REPLACE II Replaces one or more cards 

in a program. 

SEQ II Assigns nev'.’ sequence num¬ 

bers to cards within a program. 

NEWTAPE Assigns the output tape. 

Format 


Parameter ^ - The symbolic tape except system reserved tapes. 

which is to be the output tape. 





TACSERV 


Remarks 


CLASS I 
INSTRUCTIONS 


ADDPROG 


Format 


Par amele r s 


A( tion 


1. NEWTaPF miist prereae ao ji i tr lACSLRt/ instruc 
tions e.'xcpt RFV/iND. 

2, t mav no: V.r iiseci tor ap', ti , r 2'ACSFRV inst rui.t'■ jp 
except REVV.'ND, 

Class 1 instruc M'P.s pertorm all i eu ’uins of the service 
routine exr t pt 'udividual pr jgrasii <orrec lions. TACSERV 
is preset to Lie Cias-; ' tr'O'Ji’ Py ’i ^ ( ' (;cut'..Oi) of the 
NEW TAPE, CO'-'’i-' i )i o Oi'iv G.LbS J instructions 

may be issueri m ’^r’is rriiiile ;d moi program correc- 
tion s ^ • 


Transfers ,i piogr.o.m it oin an jm'i ■_ ,,jpe t > tlie output 
tape. 


L 

LjOc a’. 

Ct-unmaod j Address and Remarks 



i 

ADDPROC. ! t, o 
! . 


t - The symVicrl c tape from v liuh a program is lo be 
transferred. 

id - The idenritv ,)f the prog] am To l,n iddinl. 

Note. An asterisk t spue hied in place of t, id 
.ndio ates ti.a' a 1A( ,I. - o rd ileek tollows 
the ADDPROG comrol card and is to be 
written irniv:.' the out out tape. 

• Ail ntormation on t iron, wntoe t is positioned- is 
bypassed until tlu' TAc. L prrgrap' id is encountered. 

• The progrom i'-ientif’ed o\ i i 's c jpied onto the out- 
put tape and t ‘s p'jsitioia a a> trie Peginning of the 
next bim k fol Lov ing ir,a' p.ojgram. 

• If ADDPROG IS spei li.oJ, ah the cards following 
tliat (.onirol i -jrd. up to au,! on iuding the first END 
car ! encountered, are traur.le r rc d to the output tape. 


• If tne sentlrieL bnoch e^ oieo. ted ei ' u- to the pro¬ 
gram id, n r r ■ > r h.4 ", i i r e s u ; t. 


14 -56 





TACSERV 


Example 


COPY 


F ormat 


Parameters 


Action 


Example 


Location Command Address and Remarks 


ADDPROG TSYSCRO,NAME 1$ 


Explanation: Execution of this instruction causes all 
formation on TSYSCRO beginning at the point at which the 
tape is currently positioned, to be bypassed until TACL 
program NAME 1 is encountered. Program NAME 1 is 
then copied onto the output tape and TSYSCRO is positioned 
at the start of the next block following program NAME ! 


Transfers without change all information from an input 
tape onto the output tape until a specified sentinel is lo 
cated. 


L 

Location 

Command 

i 

Address and Remarks ! 

i 



COPY 

— 

i 

t, sent 1 

u........ „...i 


t - The symbolic tape to be copied. 


sent (OPTIONAL) - The sentinel word to be used in !o 
eating a sentinel block. The sentinel specified by a 
COPY instruction overrides a previ ous ly - spec ■ fi ed 
sentinel for the duration of that COPY instrue1 1 on. 

If sent is omitted. Z's are assumed. 


• All information on t, from where t is positioned is 
copied onto the output tape until the sentmei block 
is encountered. 

• The sentinel block is not copied onto the output taps 
and_t is positioned at the start of the next block foi 
lowing the sentinel block, 

L Location Command Address and Remarks 


COPY T-024, AAAAAAaA 


Explanation: Execution of this instruction causes all in¬ 
formation on Tape T-024j beginning at the point at which 
the tape is currently positioned, to be copied onto the 
output tape until a sentinel block of A's is encountered. 
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TACSERV 


COPY TIL 


Format 


Parameters 


Action 


Example 


CORRECT 


Format 


Parameters 


Transfers without change all information from a desig 
nated input tape to the output tape until a specified pro 
gram is encountered. 


L 

Location 

Comm bind 

Address and Remarks 



COP^ TIL 

t, id 


t - The symbolic tape to be cop ed. 


id - The identity ot the program to which the tape is to be 
c op,ed, 

• All infonndt on on t from where t is positioned, is 
copied onto the output tape unt ■ ' program is encoun- 
te red. 

• t IS positioned at the beg ntnng ot program 

• If the sentinel block is ent ountered prior to program 
id Error E4 wi 1 i r 0 su. 1 t* 

L Location Command Address and Remarks 
COP^TiL T85. GAMMA $ 


Explanation Execution of ih.s instruction causes tape 
T85, beginning at the point at which it is currently posi¬ 
tioned to be copied onto the output tape until program 
GAMMA IS encountered. The tape s pos.tioned at the 
start of GAMMA. 


Sets TACSERV to the Class ii mode (individual program 
corrections'. 


L 

Locati on 

C 0 mm arid 

Address and Remarks 



CORRECT 

t. id 


t - The symbolic tape to be cop ed. 

id (OPTIONAL) The identity of the program to be cor¬ 
rected. The id parameter may be omitted if the tape 
is pre-positioned, 
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TACSERV 


Action 


Remarks 


• All information on t, from where t is positioned, is 
copied onto the output tape until program id is en¬ 
countered. 

• t is positioned at the beginning of the designated pro¬ 
gram. 

• If id is omitted, corrections will be made from llie 
point at which the input tape is currently positmned, 

• TACSERV is set to accept Class II instructions only. 

• TACSERV is set to search for cards in the LOCFLAD 
mode (by symbolic location). (Refer to LOCFLAD ) 

• If the specified sentinel block is encountered prior to 
program id Error E4 will result. 

The Class II mode is terminated by the exe cution of an 

ENDPROG control instruction. 


Example 


L Location Command Address and Remarks 


CORRECT OLDTACL,ZEBRA $ 


DELPROG 


Format 


TrYnl;:^n;^firin 




Cl. LJ. . 


formation on Tape OLDTACL, beginning at the point at 
which the tape is currently positioned, to be copied, onto 
the output tape until program ZEBRA is encountered. 
The tape is positioned at the start of program ZEBRA. 
Class II instructions must follow. 


Deletes a specified program. 


L 

Locati on 

—--- 

Command 

Address and Remarks 



DELPROG 

t, id 


Parameters 


_t - The symbolic tape from which the program is to l)e 
deleted. 

id - The identity of the program to be deleted. 
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TACSERV 


Action 


Example 


ENDALL 

Format 

Parameters 


• t, from where t is positioned, is copied onto the out¬ 
put tape until program ^ is encountered. 

• Program id is not copied onto the output tape, but is 
bypassed and the tape is positioned at the beginning 
of the block following the program or immediately 
following the sentinel block, if one were encountered. 

• If the sentinel block is encountered prior to the pro¬ 
gram designated by id Error E4 will result. 

L Location Command Address and Remarks 


DELPROG T72, YOKE $ 


Explanation: Execution of this instruction causes all in¬ 
formation on Tape T72, beginning at the point at which 
the tape is currently positioned, to be copied onto the out¬ 
put tape until program YOKE is encountered. Program 
YOKE is not copied onto the output tape, but is bypassed 
Sind the input tape is positioned a.t the start of the next 
block following the program. 


Terminates the TACSERV service routine. 


L 

Location 

Command 

Address and Remarks 



ENDALL 

list, sent, pos 


list (OPTIONAL) - Produces a listing on TSYSOUT of the 
ID and block count of each program on the output 
Tape, plus the total block count including sentinels. 

sent (OPTIONAL) - The sentinel word to be used in writing 
the sentinel blocks. If sent is omitted, Z's are assumed. 

pos (OPTIONAL) - An alphabetic character that specifies 
the position of the output tape. If the parameter is 
omitted, the tape is positioned after the first sentinel 
block. 

L Specifies that the output tape is to be rewound 
with lockout. 

R Specifies that the output tape is to be rewound. 
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TACSERV 


Action 


• Two sentinel blocks of Z's or the configuration speci¬ 
fied by sent are written onto the output tape. 

• If LIST is specified, a listing of the ID and block 
count of each program on the output tape, plus the 
total block count including sentinels, will be produced 
for printing on the High-Speed Printer. If LIST is 
omitted, no listing will be processed. 

• The output tape is positioned according to the pos 
parameter. 

• Action of the TACSERV routine is terminated and con¬ 
trol is returned to 32KSYS via INXTCON. 


LOCATE 

Format 


Parameters 


Action 


Example 


Search for a designated program on an input tape. 


L 

Location 

Command 

Address and Remarks 



LOCATE 

t, id 


t - The symbolic tape on which the designated program is 
located. 

id - The identity of the program to oe located. 

• t is searched for program id. 

• When program id is encountered, the tape is posi¬ 
tioned at the start of the program. 

• If the sentinel block is encountered prior to program 

id, Error E4 will result. 

L Location Command Address and Remarks 

LOCATE T-024, XRAY $ 


Explanation; Execut on of this instruction causes Tape 
T-024 to be searched for program XRAY and the tape to 
be positioned at the start oi that program. 
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TACSERV 


SENTINEL 


Format 


Parameter 


Action 


Remarks 


CLASS II 
INSTRUCTIONS 


TRANSFER OF 
DATA 


Designates an ending sentinel block. 


L 

Location 

Command 

Address and Remarks 



SENTINEL 

sent 


sent - The sentinel word to be used in locating the sentinel 
block. 


• There is no immediate action. TACSERV is set so 
that the operation of all subsequent instructions - 
prior to another SENTINEL instruction - will be ter¬ 
minated whenever a sentinel block of sent is encoun¬ 
tered. 

If the SENTINEL control instruction is omitted, a sentinel 
block of 120 words of Z's will be assumed by TACSERV 
for termination of subsequent instruction action. 

Class II instructions perform individual program correc¬ 
tions such as the addition, deletion, or replacement of 
cards. TACSERV is set to accept Class II instructions 
by the execution of the CORRECT instruction. Only Class 
II instructions may be issued in this mode; otherwise. 
Error El will result. 

Only one program may be processed for each CORRECT 
instruction. Corrections to a program must be made in 
the sequential order of the program cards. 

This mode is terminated by the processing of an ENDPROG 
card. 

Whenever an ADD, REPLACE, DELADD, or DELETE in¬ 
struction is executed, information is transferred either 
from the beginning of the program being corrected, or 
from the point of last change in that program (via a previ¬ 
ous ADD, REPLACE, DELADD, or DELETE instruction) 
to the point at which cards are to be currently added, re¬ 
placed, or deleted. Whenever the ENDPROG instruction 
is executed, the balance of the program is transferred 
from the input tape to the output tape, and the Class II 
phase is terminated. 
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TACSERV 


ADD 

Format 

LOCFLAD 

mode 


Parameters 

LOCFLAD 

mode 


F ormat 

LOCSEO 

mode 

Parameters 

LOCSEO 

mode 


Action 


Adds one or more cards to a program. 


L 

Location 

Command 

Address and Remarks 



ADD 

symb, n, total j 


symb - The symbolic location used with ji that designates 
the card in front of which the new card(s) are to 

be added. 

n - A decimal number that indicates the number of card a 
beyond symb, ahead of which the cards are to be 
added, if :s zero, the card identified by sym b 
IS the one ahead of which the new cards wiil he 
added. 

total (OPTIONAL) - The number (decimal) of consecutive 
cards to be added If total iS omitted, cards wa, 
be added until a TACSERV Class li instruction .s 
encountered. 


L 

Location 

Command 

Address and Remarks 



ADD 

xxxxxxxx, total 


xxxxxxxx - The e ight-charai ler idem ry and Sequence 
field of the card in front of which new i ards are 
to be added, 

total (OPTlONALj - See description under LOCFLAD 
mode. 

• The TACL program specified by the most rei ent 
CORRECT con:ioi instruction is copied card-by- 
eard onto the output tape until the specified card 
is encountered. The specified card >s net trans¬ 
ferred to the output tape and remains availabltr 
for further processing, 

• The cards to be added are written onto tne output 
tape- The next TACSERV control instruction is 

tht.n requested. 
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TACSERV 


Remarks 


ADD Example 
LOGFLAD mode 


1. Garde are always added preceding the card 
specified by symb + n in LOCFLAD mode or 
xxxxxxxx in LOGSEQ mode. 

2. If symb is blank or zero, cards will be added 
immediately preceding the jith card beyond the 
one last affected by an ADD, DELADD, DELETE, 
or REPLAGE instruction for this program. If 
there were no such previous instructions, the 
cards will be added prior to the nth card from 
the beginning of the program. 

3. If symb and ^are both zero, the current location 
on tKe input tape is assumed. 

4. The cards to be added must immediately follow 
the ADD control instruction. 

5. If an END card is added, it must be followed by 
an ENDPROG card. Gards between the END card 
being added and the ENDPROG card will be 
ignored. 

Assume that two instructions are to be added in 

LOGFLAD mode, between the third and fourth instruc¬ 
tions of the following coding: 


L Location 

Gommand 

Address and Remarks 

TEST 

GA 



SLAO 

6 


TMD 

W/00000001 


JMP 

START 

The following TAGSERV instructions are used to add 
the new cards: 

L Location 

Gommand 

Address and Remarks 


ADD 

TEST, 3,2 


JAED 

(P) + 2H 


AM 

ZEBRA 
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ADO Example 
LOCSEO mode 


Identity 
and Sequence 

XRAY0012 

XRAY0013 

XRAY0014 

XRAY0015 


Identity 
and Sequence 


Execution of the TACSERV instruction. ADD causes 'he 
preceding portion of the program, from either its be¬ 
ginning or point of last change to the JMP START card 
(the card indicated by TEST +3; to be written onto the 
output tape. At this point, the two cards fo.llc'.»'ir.g ADO 
are written following the TMD W/OOOOOOOl card on the 
output tape. The input tape remains positioned at the 
JMP START card. 


The corrected portion of the program on the output 
tape now appears as 


— Docaricn Command 

TEST CA 

SLAG 

TMD 

JAED 

AM 

JMP 


Address and Remarks 


6 

W/OOOCOOOI 
fP) -2H 
ZEBRA 
START 


Assume that two instructions are to be added in 
LOCSEO mode preceding the fourth instruction of the 
coding below. 

L Lo c at ion C ommand Address and Remarks 


Ca 

SLAQ 6 

TMD W/00000001 

JMP START 


The following TACSERV instructions are used to enter 
the new cards: 

ic Location Command Address and Remarks 


ADD 

JAED 

AM 

ENDPROG 


XPAY00i5 
(P) + 2H 
ZEBRA 


Execution of the TACSERV instruction ADD causes the 
preceding portion of the program, from either its 
beginning or point of last change up to, but not including 
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TACSERV 


Identity 
and Sequence 


XRAY0012 

XRAY0013 

XRAY0014 


XRAY0015 


DELADD 


r ormat 

LOCFLAD 

mode 

Parameters 

LOCFLAD 

mode 


Format 

L6CSEQ 

mode 
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card XRAY0015 (JMP START), to be written onto the 
output tape. At this point, the two cards following ADD 
are written following the TMD W/00000001 card onto 


A A »< ^ I 1 TZ) T3 . .. _ . 




atej 


there are no further corrections to be made to this pro¬ 
gram, and the remainder of the program is transferred 
to the output tape. 


The corrected portion of the program on the output tape 
now appears as: 


L Location Command Address and Remarks 


CA 


SLAO 

6 

TMD 

W/00000001 

JAED 

(P) t 2H 

AM 

ZEBRA 

JMP 

START 


Deletes one or more cards from a TACL program, then 
adds cards until the next TACSERV control is encountered. 


L 

Location 

Command 

Address and Remarks 



DELADD 

symb, n, total 


symb - The symbolic location used in conjunction with 
_n_that designates the first card to be deleted. 

_n - The number (decimal) of cards past the card 
(designated by symb ) of the first card to be 
deleted. Ifjr is zero, the card identified by 
symb will be the first to be deleted. 


total (OPTIONAL) - The number (decimal) of cards to 
be deleted. If total is omitted, one card will be 
deleted. 


L 

Location 

Command 

-;-1 

Address and Remarks 



DELADD 

XXXXXXXX, total 





TACSERV 


Parameters 

LOCSEO 

mode 


-Action 


Remarks 


DELADD Example 
LOCFLAD mode 


XXXXXXXX - The eight-character Identity and Sequence 
field of the first card to be deleted. 


total (OPTIONAL) - The number (decimal) of cards to 
be deleted. If total is omitted one card will be 
deleted. 


The TACL program designated by the most recent 
CORRECT instruction is copied cacd-by-card onto 
the output tape until the specified card is encountered. 

Cards are transferred from TSYSIN' to the output 
tape until a TACSERV Class II instruction is en¬ 
countered. Then the total number of cards start¬ 
ing with the specified card is deleted. 


1. If symb is blank or zero, cards will be deleted 
from the n_th card beyond the last cop referenced 
m a previous ADD, DELADD, DELETE or RE¬ 
PLACE instruction for this program. If there 
were no such previous instructions, cards will be 
deleted from the nth card of the program. 

2. If symb and n are both zero, the current location 
on the input tape is assumed. 


The processing of an END card will terminate the 
DELADD function. If the END card is detected 
during the delete phase, Error Ell will result. 


Assume that the third and fourth instructions are to be 
deleted in LOCFLAD mode from the following coding, 
and three instructions are to be added. 


Location Command 

TEST CA 

SLAO 

TOD 

JMP 

TMD 

JAED 

AM 

JMP 


Address and Remarks 


b 

OUT 

W/000000 01 
(P) + 2H 
ZEBRA 
START 



TACSERV 


The following TACSERV instruction is used to delete 
the two instructions and add three In their place. 

E l.ocation Command Address and Remarks 


DELADD 

TOM 

TMO 

JMP 


TEST 2,2 
ERR 
MASK] 
OUT A 


iV-: i.ETE 

I- ormat 
J-,OCFLAD 
n lOde 


Pa ramete rs 
IOOFLAD 
rriode 


Execution of the TACSERV Ir sTruction DELADD causes 
the preceding portion of the program, from either its 
beginning or point of last change up to but not including 
the TQD instruction, to be written on the output tape. 

At this point, the TOD instruction and the one immediately- 
following it are b-ypassea or the input tape and the tape is 
positioned at the TMD W/00000001 card. 

The corrected portion of the program on the output tape 
now appears as: 

L Location Commar.d Address and Remarks 


TEST CA 

SLAO 6 

TOM ERR 

TMO MASK! 

JMP OUT A 

The card TMD W/00000001 and those following remain 
on the input tape and are available for further process¬ 
ing. 


Deletes one or more c ards from a TACL program. 


L 

Location 

C ommand 

Address and Remarks 



DELETE 

symb r , total 


symb - The symbolic location used in conjunction with 
n_ that designates the first card to be deleted. 

n^ - The number (decimai) of cards past the card 
(designated by symb) of th' f rst card to be 
deleted. If n is zero, the card identified by 
symb will be the first to be deisted. 
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TAGSERV 


Fermat 

LOCSEO mode 


Parameters 
LOCSEQ mode 


Action 


Remarks 


total (OPTIONAL) - The number (decimal) of cards to 
be deleted, or TO END to delete all cards from 
where the program is positioned, up to but not 
including the END card of the program being 
revised. If total is omitted, one card will be 
deleted. 


L 

Location 

Command 

Address and Remarks 



DELETE 

xxxxxxxx, total 


xxxxxxxx - The eight-character Identity and Sequence 
field of the first card to be deleted. 

total (OPTIONAL) - See DELETE, LOCFLAD mode. 

The TACL program designated by the most recent 
CORRECT instruction is copied card-by-card onto the 
output tape until the specified card is encountered. 

The specified card (first card to be deleted) plus all 
subsequent consecutive cards as determined by total 
are bypassed on the input tape. The input tape is 
positioned at the card following the last one bypassed. 

If TO END is specified as total, all cards of the pro¬ 
gram being revised, from the specified card up to but 
not including the END card, will be bypassed (deleted). 
The input tape will then be positioned at the END card, 

1. If symb is blank or zero, cards will be deleted 
starting with the j^th card beyond the last one re¬ 
ferenced in a previous ADD, DELETE or REPLACE 
instruction for this program. K there were no such 
previous instructions, cards will be deleted be¬ 
ginning with the _nth card of the program. 

2. If symb and are both zero, the current location 
on the input tape is assumed. 

3. An END card of a program being revised cannot 
be deleted. 


1 






DELETE Example 
LOCFLAD mode 


ENDPROG 
F ormat 


Assume that the third and fourth instructions are to be 
deleted in LOCFLAD mode from the following coding. 


L 

Location 

Command 

Address and Remarks 


TEST 

CA 




SLAO 

6 



TOD 




JMP 

OUT 



TMD 

W/00000001 



JAED 

(P) + 2H 



AM 

ZEBRA 



JMP 

START 

The following TACSERV instruction is used to delete 

the 

two instructions. 


L 

Location 

Command 

Address and Remarks 


DELETE TEST. 2,2 

Execution of the TACSERV instruction DELETE causes 
the preceding portion of the program, from either its 
beginning or point of last change, up to but not including 
the TOD instruction, to be written on the output tape. 

At this point, the TOD instruction and the one immedi¬ 
ately following it are bypassed on the input tape and the 
tape is positioned at the TMD W/OOOOOOOl card. 

The corrected portion of the program on the output tape 
now appears as: 

L Location Command Address and Remarks 

TEST CA 

SLAO 6 

The card TMD W/00000001 and those following remain 
on the input tape and are available for further processing. 


Terminates individual program correction. 


L 

Location 

Command 

Address and Remarks 



ENDPROG 
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TACSERV 


Parameters 

Action 


Remarks 

LOCFLAD 

Format 

Parameters 

Action 

Remarks 

LOCSEQ 

Format 


None 

e The balance of the program being corrected, from 
the point at which the tape is currently positioned, 
is copied onto the output tape. 

e The input tape is positioned at the beginning of 
the block following the last block of the program 
just processed. 

• TACSERV is set to NOSEQ mode, and reset to 
accept Class 1 instruction. 

An ENDPROG card must always be used to terminate 

the correction of a program. 


Sets the TACSERV routine to find cards by symbolic 
address for subsequent ADD, DELADD, DELETE, and 
J^EPLACE control instructions. 


L 

Location 

— 

Command 

Address and Remarks 



LOCFLAD 



None 


There is no immediate action. All subsequent card 
searching within the current CORRECT instruction 
phase is set to use symbolic addresses in the 
Location field. 

TACSERV is automatically set to the LOCFLAD 
mode of operation whenever a CORRECT instruc¬ 
tion is executed. 

The LOCFLAD mode is terminated by the execution 
of a LOCSEQ instruction. 


Sets the TACSERV routine to find cards by Identity and 
Sequence number for subsequent ADD, DELADD, 
DELETE, and REPLACE control instructions. 


L 

Location 

Command 

Address and Remarks 



LOCSEQ 

RIGHT 
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* TACSERV 

PartMt«ri 

Action 

REMARKS 

NOSEQ 


Format 

Parameters 

Action 

REPLACE 

F ormat 

LOCFLAD 

mode 


Parameters 

LOCFLAD 

mode 
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RIGHT-(OPTIONAL) - Specifies that the sequencing and locating of 
cards by identity and sequence numbers viil be done on the right- 
hand side of cards, columns 73 thru PO. If RIGHT is aamitted, 
card searching and sequencing will be perforsMd on the left-hand 
side of the cards, columns 1 through B, 

There is no iimediate action. All subsequent card searching within 
the current CORRECT instnaction ohase will be performed according 
to the above parameter specifications. 

1. If RIGHT is specified subsequent LOCFLAD, LOCSEQ, or SEQ Instructions 
will not terminate right-hand side sequencing. Right-hand sequencing 
can only be terminated by the execution of NOSEQ or ENDPROG in3tructi( 

2, The LOCSEQ mode of card-searching is terminated by the execution of a 
LOCFLAD or ENDPROG instruction. 

Terminates assignment of new sequence numbers to 
cards of a TACL program being corrected. (Assign¬ 
ment of sequence numbers is initiated by the SEO con¬ 
trol instruction). 


L 

Location 

Command 

Address and Remarks 



NOSEQ 



None 


• There is no immediate action. When NOSEQ is 

executed, all cards written on the output tape from 
this point forward will he trans^'erred with their 
Identity and Sequence field unaltered. 


Replaces one or more cards in the TACL program. 
REPLACE operates either in LOCFLAD or LOCSEQ 
mode. 


L 

Location 

Command 

Address and Remarks 



REPLACE 

symb, n, total 


symb - The symbolic location used in conjunction with 
ri of the first card to be replaced. 

- The number (decimal) of cards past the card 
(designated by symb ) of the first card to be re¬ 
placed. If n is zero, the card identified by symb 
will be the first to be replaced. 

total (OPTIONAL) - The number (decimal) of consecutive 
cards to be replaced. If total is omitted, one card 
will be replaced. 
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TACSSRV 


F ormat 

LOCSEQ 

mode 


Parameters 
LOCSEQ mode 


Action 


Remarks 


REPLACE Example 
LOCFLAD mode 


L 

Location 

Command 

Address and Remarks 



REPLACE 

xxxxxxxx, total 


xxxxxxxx - The eight-character Identity and Sequence 
field of the first card to be replaced. 

total (OPTIONAL) - The number (decimal) of consecutive 
cards to be replaced. If total is omitted, one card 
will be replaced. 

• The TACL program specified by the most recent 
CORRECT instruction is copied card-by-card onto 
the output tape until the specified card is en¬ 
countered. 

• The specified card plus subsequent cards as a ’■er- 
mined by total are replaced. Their corresponding 
replacement cards (following the REPLACE instruc¬ 
tion; are writter. onto the output tape The input 
tape :s positioned at the card following the last one 
replaced. 

1. If symb is biank or zero, cards will be replaced 
starting U'ith the nth card beyond the last one 
referenced in a previous ADD, DELETE, or RE¬ 
PLACE instructior fur this program. If there 
were no previous such irstructions, cards will be 
replaced begiiining wiih *he ^th card of the program, 

2 ..f symb and r. are both zero, the current location 

on the input tape ,e assumed 

3. i he replace lur.,.tiOn be terminated whenever 
an END c^rd is processed- An END card may be 
used to replace any other card, but an END card 
must not be replaced by another card, 

Assume that the third and fourth instructions are to be 

replaced in LOCFLAD mode in ih*’ following coding, 

— ioj^^ Command Address and Remarks 

TMD W/00000001 

JAED (P) + 2H 

TEST CA 


1 A.-r-x 




TACSERV 


REPLACE 
Example 
LOCFLAD Mode 
(Continued) 


SEQ 


L Location Command 

SLAO 

TMQ 

JAEO 

AM 

JMP 


Address and Remarks 

6 

W/77777777 
(P)+ 3H 
ZEBRA 
START 


The following TACSERV instruction is used to replace 
the two instructions. 

^ Location Command Address and Remarks 
REPLACE TEST, 2.2 


Execution of the TACSERV instruction REPLACE causes 
the preceding portion of the program, from either its 
beginning or point of last change up to but not including, 
the TMQ W/77777777 card (indicated by TEST+2), to 
be written on the output tape. At this point, the TMQ 
W/77777777 card and the one following on the input 
tape are bypassed. The two cards following REPLACE 
are written on the output tape following SLAQ 6. 

The input tape remains positioned at the AM ZEBRA 
card, which is available for further processing. 

The revised portion of the program on the output tape 
now appears as: 


L Location Command 


Address and Remarks 


TEST CA 

SLAQ 

TMD 

JAED 


6 

W/00000001 
(P) + 2H 


Sets TACSERV to assign new sequence numbers, be¬ 
ginning with a designated configuration, to each sub¬ 
sequent card of a TAC language program being trans¬ 
ferred to the output tape. 
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TACSER/ 


F ormat 


L 

Location 

Command 

Address and Remarks 



SEQ 

seqno. inc, cols 



Parameters segno (OPTIONAL) - Eight alphanumeric characters to 

be placed in the Identity and Sequence field of the 
next output card of the program being revised. 

The segno parameter may consist of zero to eight 
alphabetic characters or spaces followed by zero 
to eight decimal characters. The total must be 
eight, representing the eight columns of the Identity 
and Sequence field. (If segno is omitted, the Identity 
and Sequence field of the first card transferred to 
the output tape will be transferred as the first se¬ 
quence number.) See Note; below 

inc (OPTIONAL) - The number (decimal) by which 

segno is to be incremented from card to card. If 
inc is omitted, an increment of one will be assumed. 

cols (OPTIONAL) - The number (1 through 8) of columns 
of segno that will be affected by the incrementing 
process. If cols is omitted, four columns will be 
assumed. 

There is no immediate action. All cards transferred 
to the output tape following execution of the SEQ 
instruction will be sequenced according to the above 
parameter specifications. 

c 

Incrementation numbering is modulo 10 , where 
c_is the number of columns to be affected. 

Sequencing is terminated by the NOSEQ control in¬ 
struction or the ENDPROG control instruction. 

Each of the SEO parameters may be used independ¬ 
ently of the others, or may be omitted. 

If all parameters are omitted, the sequence number 
of the first card transferred to the output tape 
following execution of the SEQ instruction will be 
assumed as the initial sequence number. Subsequent 
cards will be sequenced in Columns 5, 6, 7, and 8 
and incremented by one. 

Note: If sequencing is to occur on the right-hand aide of the cards 
(colunns 73 through PO), the SEQ control instruction must be 
preceded by a LOCSEQ irstruction specifying RIGHT in the 
Address and Rsnarks field. 


Action e 

Remarks 1. 

2 . 

3. 

4. 


bev. Karch, l%8 
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TACSERV 


5. If only the first parameter segno is specilied, 
seqno will be the sequence number of the first 
card. Subsequent cards will be secjuenced on the 
last four columns and incremented by one. 

6. If only the first two parameters seqno and inc are 
specified cols will be four, witli an increment 
designated by inc. 

7. If the first parameter Is omitted, but the remain¬ 
ing two are specified, the identity and Sequence 
field of the first card will be assumed. 

8. If the first two parameters are omitted and cols 
is specified, the Identity and Sequence field of the 
first card will be assumed, and subsequent card 
sequence numbers will be incremented by one. 
Columns will be affected as indicated by cols . 

9. If the first and third parameters are omitted and 
only inc is specified, the Identity and Setjuence 
field of the first card will be assumed. Incremen¬ 
tation will be indicated by iiac and four columns are 
to be affected by the sequent ing process. 


TACSERV 

OUTPUT 


Program 

Listing 


Console 

Typewriter 


Output from TACSERV may cor.sist of an updated TAC 
language tape and a printed listing ot programs written 
onto the output tape. If a TACSERV^ control instruc¬ 
tion error is detected, the error will be indicated on the 
Console Typewriter ar.d High-Speed Printer. 

K LIST is written as a parameter of the ENDALL con¬ 
trol instruction, a listing of the ID and block count of 
each program written on the output tape plus the total 
block count including sentinels, will be edited and placed 
on TSYSOUT, edited for printing on the High-Speed 
Printer. 

Whenever an error is detected during operation of the 
TACSERV routine, the following indication is typed 
on the Console Typewriter; 

TAGS En 

where _n_ indicates the type of error as described belown 
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TACSERV 


High-Speed 
Printer Error 
Indications 


Error 

Exit 


Detection of an error also causes the following indication 
to be written on the system output tape, edited for print¬ 
ing on the High-Speed Printer: 


card contents 








TACSERV Error: 


Error Statement 


where card contents is the illegal card, and error 
statement is the appropriate error message. 

Following detection and indication of the TACSERV 
error control is transferred to lENDJOB. A listing 
of all TACSERV errors follows; 


Type-Out 

Print-Out 

TACSEl 

ILLEGAL CONTROL CARD 

TACSE2 

TAPE SPECIFIED IS NEWTAPE OR IS 

A RESERVED SYSTEM TAPE 

TACSE3 

NEWTAPE HAS NOT BEEN 

SPECIFIED 

TACSE4 

SENTINEL BLOCK PREVENTED 
COMPLETION OF FUNCTION 

TACSE5 

END CARD FOUND BEFORE SPECIFIED 
FLAD/SEOUENCE - NUMBER 

TACSE6 

ATTEMPTED DELETION OF END CARD 

TACSE7 

MORE THAN 8 CHARACTERS IN 
SENTINEL PARAMETER 

TACSE8 

ILLEGAL PARAMETER IN ENDALL 
CARD 

TACSE9 

"1" CARD INTERCEPTED 

TACSEIO 

CARD(S) IGNORED DURING SEARCH 

FOR "ENDPROG" CARD 

TACSEl 1 

ATTEMPTED REPLACEMENT OF AN 
"END" CARD -- NEW CARD NOT "END" 

TACSE12 

CARD SPECIFIED BY SYMB PLUS N 

HAS ALREADY BEEN TRANSFERRED 

TACSEl 3 

MORE THAN 8 CHARACTERS IN 
SEQUENCE PARAMETER 


1 4 . '7 -7 

i -r — I I 



TACSERV 


'T A ncVT? V 

EXAMPLE 


A fKr.f 11 r> •*■ r> nr T» rs T-»-> c r\T> T OTHTArT, unto 

but not including program ZEBRA, and all programs 
on Tape ADDTAPE, up to and including program ABLE, 
are to be transferred to t ape Nh-W l ACL. Program 
ABLE is to be revised as it is tr msferred. 


L Location Command 


NEWTAPE 

REWIND 


COPYTIL 

CORRECT 

LOCSEO 

SEO 

ADD 

TMA 

ENDPROG 

ENDALL 


Address and Remarks 


NEWTACL 

$(i) 

OLi )'I ACL, 


ADDTAPE. 


NEWTACL 

$(2) 

OLDTACL,ZEBRA 

$(3) 

ADDTAPE,ABLE 

$(4) 


$(5) 

ABLEOOOl, , 3 

$(6) 

ABLE0032, 1 

$(7) 

CARD 

$(8) 


$(9) 

LIST, BBBBBBBB 

$(10) 


Explanation - Execution of these instructions causes 

the following action to take place: 

1. Tape NEWTACL is assigned as the output tape. 

2. Tapes OLDTACL, ADDTAPE, and NEWTACL are 
rewound. 

3. All information prior to program ZEBRA on tape 
OLDTACL is transferred to tape NEWTACL, 

4. All information prior to program ABLE on tape 
ADDTAPE is transferred to tape NEWTACL, and 
TACSERV is set to the Class II mode. 

5. TACSERV is set to search for cards by sequence 
number. 

6. TACSERV is set to assign sequence numbers to 
cards within the corrected program ABLE. 
Sequencing will begin with ABLEOOOOl and incre¬ 
mentation will be by one. 

7. The portion of program ABLE prior to card 
ABLE0032 is transferred to tape NEWTACL. 
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8. TMA CAilD is written on tape NEWTACL. 

9. The remaining portion of program ABLE is trans¬ 
ferred to tape NEWTACL and tape ADDTAPE is 
positioned at the beginning of the block following 
the last block of program ABLE. TACSERV is 
set to NOSEQ mode, and reset to accept CLASS I 
in structions. 

10. Two sentinel blocks of B's are written on tape 

NEWTACL. A listing of the ID and block count of 
each program written on tape NEWTACL plus 
total block count is written on TSYSOUT and control 
is returned to 32KSYS. 
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TAPEDUMP 


TAPEDUMP SERVICE ROUTINE 


FUNCTION 


SERVICE 

ROUTINE 

INITIATION 


INPUT-OUTPUT 

SYSTEM 

CONTROL 

INSTRUCTIONS 


Edits information from a magnetic tape for printing in 
various formats. 


The TAPEDUMP services routine may be called into 
operation by the following instruction: 


L 

Location 

Command 

Address and Remarks 



TAPEDUMP 



TAPEDUMP uses 32KSYS XORD for all tape move¬ 
ments . 


TAPEDUMP accepts five control instructions written 
in standard 32KSYS control line format: 


Instruction 


F unction 


PROCESS 


REWIND 


Processes the designated tape, con¬ 
verting and editing tlie data as specified 
^ncl writing thiG out put on TSYSOUTs 


Rewinds one or more tapes. The func¬ 
tion is as described in Tape Handling. 


SPACEF 


Spaces forward on the designated tape. 


SPACER Spaces backward on the designated tape. 

ENDALL Terminates the action of the TAPEDUMP 

routine and returns control to 32KSYS. 


PROCESS 

Format 


Parameters 

n - The number (decimal) of blocks to be processed. 


L 

Location 

Command 

Address and Remarks 



PROCESS 

t, n, f 



PROCESS 

t, sent, f 






^ - The symbolic tape except TSYSDMP, TSYSOUT, 
and TSYSIN, to be processed. 


14-80 




TAPEDUMP 


SPACEF 

Format 

Parameters 

Remarks 

SPACEB 

Format 

Parameters 

Remarks 


sent - the sentinel word to be used in locating a sentinel 
block. 

_f - Analphabetic character that specifies the format in 
which the tape is to be edited. 

A = Alphanumeric 
H = Hexadecimal 
O = Octal 
F = Floating-point 

nS = Fixed-point, where ti is a decimal 
number from 0 through 47, which 
indicates the position of the binary 
point. If 11 is omitted, 0 will be 
assumed. 


L 

Location 

Command 

Address and Remarks 



SPACEF 

SPACEF 

t ji 

t, sent 


See PROCESS 


If sent is specified, the tape will be positioned immedi¬ 
ately following the sentinel block. 


L 

Location 

Command 

Address and Remarks 



SPACEB 

t, n 



SPACEB 

sent 






See PROCESS 

If sent is specified, the tape will be positioned immedi¬ 
ately following the senrii el block (in referenc e to a 
backward direction). 
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TAPEDUMP 


irNTr»A T T . 

Format 

Parameters 

Action 


L 

Location 

Command 

Address and Remarks 



ENDALL 



None 

TAPEDUMP is terminated and control is returned via 
SYS. INXTCON 
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SECTION XV 


APPLICATIONS 


This section deals with applications whi-h 
run under control of the 32KSYS monitor. 
Information relevant to use of the application 
system within the monitor Is Included; de¬ 
tailed information as to the input and output 
formats, options, etc., can be found in the 
documents referenced by each application. 



PERT 


PERT - Performance Evaluation and Review Techni(|ue 


FUNCTION 

FORMAT 


PARAMETERS 


ACTION 


REFERENCE 


Initializes a PERT run. 


L 

Location 

Command 

Address and Remarks 


run 

PERT m 

ll • *2 • - 


run - Signifies an initial run or an update run to an 

existing Master File. One of the following two para¬ 
meters must be written in the location field: 

• INITIAL - an initial run 

• UPDATE - an update run to an existing Master File. 

1 (OPTIONAL) - The symbolic tape indicating the 
existing Master File. If not present, run must be 
INITIAL. 

t - - The symbolic tape indicating the new Master File. 

n^ - The number (decimal) of tape transports available 

to PERT III. If r^is unspecified or is greater than 10, 
PERT III will utilize up to eleven tape transports. If 
n = 10 and an old master file tape is specified, PERT 
III will rewind TSYSCR7 to provide a transport on 
which to mount a file tape. If n is less than ten an 
error typeout will ensue and the run will be term! - 
nated. 

e The input deck is read, sorted, and merged (if 

an UPDATE run) with the existing Master File to 
create a new Master File tape. 

e PERT computations are performed. 

e Output reports are generated. 

The program is described in TM-30, Philco 2000 PERT 

III System. 
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PERT 


REMARKS 


CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 


CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 


If a PERT III run is successfully completed, the 
program returns to the system via SYS. INXTCON. 
Otherwise, control is returned via SYS. lERRDMP. 


Message 

PERT III 

MASTER FILE 
ON T XX 


Explanation 

Start of run 

Location of new 
Master File 


Message 


Explanation 


Action 


DUMPPERT 


Machine or pro¬ 
gram error. 
Computer halts. 


Dump memory 
and contact 
Phiico Program¬ 
ming R it D 
Dept. 


TOO MANY Input data error 
PREDECES¬ 
SORS OR 
SUCCESSORS 


None. Returns 
to SYS. lERRDMP 


BAD CONTROL Illegal or missing 
CARD parameter(s) in 

PERT III control 
card. 


None. Returns 
to SYS. lERRDMP 
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STAT/2000 


FUNCTION 

FORMAT 

PARAMETERS 


REMARKS 

REFERENCE 


STAT/20(X) 


Initiates a STAT/2000 run. 

L ! Location Command 

'"'V' . -- 

1 Address and Remarks 

1 ; STAT 

1 

t 

tt (S), t2 (S) 


t. - The symbolic tape to be used for storage of data 
~ values. If omitted, TSYSCR3 is assigned to . 

t 2 “ The symbolic tape to be used for storage of data 
~ results. If omitted, TSYSCR6 is assigned to^ 2 • 

(S) (OPTIONAL) - Indicates that_t I and/or J 2 is to be 

rewound with lockout. This allows the tapes to be saved 
for future use on NODATA or FOLLOW option. 

(Refer to Philco Manual TM-36.) 

The STAT/2000 System is loaded into core. 

Tkg jnpijf deck is read and the reauested stotistlcal 
function is performed. 

Both printer and plotter output are placed on tape 
TSYSOUT. 

. Subsequent statistical functions are loaded and executed 
until an ENDSTAT control card is encountered. 

. _t I and t^2 handled as specified by the STAT card, i.e., 
they are rewound with lockout if (S) has been requested. 

The use of (S) eliminates the ability to stack runs. When additional 
statistical functions are desired, the STAT control instruction must 
be resubmitted releasing tapes t_| and _t 2 • 

STAT/2000 control cards. Individual statistical programs, and console 
typewriter typeouts are described in the Philco Manual TM-36. 
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XMAS 


FUNCTION 

FORMAT 

PARAMETERS 

ACTION 

REFERENCE 


XMAS - Esqiandable Machine Accounting System 


Initiates an XMAS run. 


L 

Location 

Command 

Address and Remarks 



XMAS 



None 


• Loads the XMAS Monitor program and transfers 
control to it. 

• The XMAS Monitor then reads the parameter 
cards following the XMAS control instruction 
and calls on the XMAS programs required for 
calculating, collating, report writing, selecting 
or sorting 80 character card records. 

The status of XMAS tapes, the programming language, 
and console typewriter typeouts are described by TM-28, 
Philco 2000 XMAS System Manual. 
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LP 


LP - Linear Programming 


FUNCTION 




FORMAT 


ACTION 


REMARKS 


L 

■ ■ 

Location 

Command 

Address and Remarks 



LP 



• LP reads the input data and subsequent control 
cards following the LP control instruction. 

• LP computations are performed. 

• Printer output is placed on tape TSYSOUT. 

1. TSYSCRO is used as the scratch for History Tape. 

2. If an LP run is successfully completed, the pro¬ 
gram returns to the system via SYS. INXTCON. 
Otherwise, control is returned via SYS. lERRDMP. 


REFERENCE 


The program is described in TM-7, Philco 2000 Linear 
Programming System. 




SECTION XVI 

TAG LIBRARY ROUTINES 


Associated with 32KSYS are several sub¬ 
routines and generators available for place¬ 
ment on the TAG library tape (TSYSLIB). 
These subroutines and generators have 
application only within programs run under 
control of 32KSYS. 

32KSYS generators such as SNAPGEN and 
LOADGEN, provide at compilation time 

machine language for specific 32KSYS func¬ 
tions . 


32KSYS generators are called into operation 
using the call word in the Command field and 
the parameters in the Address and Remarks 
iield. 



hOADGEV 


LOADGEN - Loading Generator 


FUNCTION 


FORMAT 


PARAMETERS 


ACTION 


REMARKS 


I _ ■> 



Generates machine coding at compilation time, which, 
when executed, causes a program to be loaded via the 
internal loader. LOADGEN enables a program to be 
loaded during the running of another program. 


L 

Location 

Command 

Address and Remarks 



LOADRPL 

or 

LOADABS 

n, ^ $ 


LOADRPL - Indicates that a normal RPL program is 
to be loaded, 

LOADABS - Indicates that an ABS program is to be 
loaded. 

_ _ T’l,,* T3TTM 0 throuffh 15), of the tape from 

ti — - - C* 

which the program is to be loaded. It may also be 
the symbolic location of a word which contains the 
PUN in bit positions 18 through 23. 

id - The identity of the program to be loaded. 

go (OPTIONAL) - If GO is written, control will be 

transferred to the program just loaded. If omitted, 
control will be returned to the calling program after 
program id has been loaded. 

During compilation of the object- program., TAG re¬ 
places the programmer's LOADGEN call with a trans¬ 
fer of control to the coding generated by LOADGEN, 

1 , After a program is loaded via LOADGEN, control 
may be transferred to it, or be returned to the 
original program. 

2. Each error condition that is detected by LOADGEN 
will generate; 

a. Coding that includes a IMP SYS. lERRDMP 
instruction, causing an automatic error 
dump at run time. 




LOADGEN 


b. A comment card, which defines the error 
condition. This card will not have an 
asterisk in column 9, therefore causing 
compilation error. 

c. The comment card THE REMAINING 
CHARACTERS IN THIS CALL ARE ...... 

followed by a comment card(s) with the 
remaining characters of the call. 

The 32KSYS internal loader may also be used at 
run time by a transfer of control to SYS. IINTLD. 


EXAMPLE 


L 


Location Command 


Address and Remarks 


LOADRF^L 6,SEG1, GO$ 


Explanation: Execution of this instruction causes coding 
to be generated at compilation time, that will load pro¬ 
gram SEGl, located on PUN 6, into memory at run time 
in RPL format. Control is transferred to SEGl im¬ 
mediately after it is loaded. The tape on PUN6 remains 
positioned at the end of SEGl, 


16-3 



SNAPGEN 


SNAPGEN - Snapshot Generator 


function 


CALL WORDS 


SNAP FORMAT 


SNAPTOG 

FORMAT 


PARAMETERS 


Generates machine coding at compilation time, which, 
when executed, produces selective snapshot dumps 
during the running of an object program whenever 
designated conditions are met. SNAPGEN produces 
the same snapshot dumps as those produced by the 
SNAP control instruction. 

The SNAPGEN generator may be called either by a 
SNAP or a SNAPTOG call word. SNAP requests a 
dump whenever specified conditions are met; SNAPTOG 
indicates that the snapshot dump is to take place (depend¬ 
ing upon conditions) only if a designated toggle switch is 
in the ON position during the running of a program. 


L 

Location 

— 

Command 

Address and Remarks 



SNAP 

format: start:end;cond$ 


L 

Location 

— 

Command 

Address and Remarks 



SNAPTOG 

tog:format: start:end;cond$ 


All parameters must be separated by semicolons, 

tog (for SNAPTOG only) - The number (decimal, 0 through 
47), which indicates the toggle switch that must be in 
the ON position before this particular snapshot dump 
can occur. The parameter may also be a symbol 
defined by an ASGN or SAME card at compilation 
time as a decimal number, 0 through 47. 

format - See format parameter of SNAP control instruc¬ 
tion. 

start - An absolute or symbolic location which indicates 
the first word to be dumped. Any numeric designa¬ 
tion is assumed to be decimal. Any configuration 
preceded by an M/ is assumed to be octal. 
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8NAPGEN 


ACTION 


REMARKS 


EXAMPLE 


end - An absolute or symbolic location which indicates 
the last word to be dumped. The same rules for 
start pertain to end . 

cond (OPTIONAL) - See cond parameter of SNAP control 
instruction. If cond is specified, all numbers are 
assumed to be decimal. M/designations may only 
be used within parenthesized expressions. A dollar 
sign ($) must follow cond . If cond is omitted, the 
dump is assumed to be unconditional, and a dollar 
sign ($) must follow the end parameter. 

During compilation of the object program, TAG replaces 
the programmer's SNAPGEN call with coding generated 
by SNAPGEN. Included in this coding is a snap table 
which contains the information required to perform the 
snapshot dump, and the call upon the snapshot routine. 

1. SNAP generator calls may not be placed under 
the influence of an RPT, TIO, or SKC instruc¬ 
tion. 

L. Upon execution of the generated coding, the contents 
of the JA Register are not saved. 

3. There is not limit to the number of calls within a 
particular program. If an error is detected by 
SNAPGEN during compilation, coding will be 
generated, which will enable each call containing 
an error to be bypassed at run time. For each 
snap error detected, the error condition will be 
printed on the Code-Edit, along with the statement. 
THE REMAINING CHARACTERS IN THIS CALL 
ARE XX. . . X, where the x's indicate the remainini! 
characters, if any, in the Address and Remarks 
field. 

L Location Command Address and Remarks 


TMA 

TMD 

JAED 

SNAP 


2052$ 

2047$ 

FINIS$ 

A;1094;JOE;5/9$ 
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SHAPGEN 


Location Command 


Address and Remarks 


TMA XRAY$ 

AMS GEORGE$ 

SNAPTOG 1;C;START. 1X;START. 
3X;A <3210$ 


Explanation: The SNAP call causes an alphanumeric 
snapshot dump of decimal location 1094 to memory 
location JOE the fifth through the ninth time the SNAP 
call is encountered. The SNAPTOG call causes a com¬ 
mand dump of memory location START plus the con¬ 
tents of Index Register 1 through memory location 
START plus the contents of Index Register 3, if Toggle 
Switch 1 is set to the ON position and if the contents 
of the A Register are less than 3210. 
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APPENDIX A 


INITIALIZATION 
of 32KSYS 


32KSYS OPERATING PROCEDURES 


In order to initialize the Philco 32KSYS Operating 
Syitem, 32KSYS, the operator should perform the 
following operations: 

1. For ease of operation, plug the logical and 
physical tape units one-to-one. 

2, Mount the System Tape on Tape Transport 1 and 
a scratch tape on Tape Transport 2. 

Magtape Image Mode: 

a. Set all toggles off. 

b. Read one block from Tape 1 into 
Memory Location Zero. 

c. Execute a JMPL Zero. 

d. 32KSYS (DATE OF VERSION) is typed on 
the Console Typewriter. 

e. 32KSYS will proceed automatically. 
Magtape Code Mode: 

a. Set Toggle 47 on. 

b. Read one block from Tape 1 into 
Memory Location Zero. 

c. Execute a JMPL Zero. 

d. SET TOGGLES is typed on the Console 
Typewriter and the computer stalls. 
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e. Set Toggle Z1 on. 

f. Set Toggle 47 off. 

g. The white light signal of the Console Type 
writer comes on and the computer stalls. 

h. Set Toggle 21 off. 

i. Type in normal 32KSYS format: 

CONIN CODE 


Console Typewriter 


a. Set Toggle 47 on. 

b. Read one block from Tape 1 into Memory 
Location Zero. 


c. Execute a JMPL Zero. 


^ C r 

It? W ^ ^ W <.0. 


nP \rr\c 
^ y 


writer and the computer stalls. 


e. Set Toggle 21 on. 


f. Set Toggle 47 off. 

g. The white light signal of the Console Type¬ 
writer comes on and the computer stalls. 


h. 32KSYS is now set to accept all input via 
the Console Typewriter (Refer to Special 
Operator Actions, Toggle 21; also refer 
to CONTROL LINE FUNCTIONS, Control 
Line Format.) 


Remarks; If a 32KSYS or Service Routine 
control line error occurs while 
in Console Typewriter Mode, the 
operator must clear error condi¬ 
tions by typing a JOB control in¬ 
struction before continuing the 
function. 
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EXECUTION OF 
A CLOBDUMP 


TAPE 

ASSIGNMENTS 


STANDARD 

SYSTEM 

TAPE 

REQUESTS 


In order to execute a 32KSYS catastrophic dump 
(CLOBDMP), assuming Magtape Code Mode, the 
operator should perform the following actions: 


1. Rewind Tape 1. 

2. Write one block from Memory Location Zero 
onto scratch tape on Tape Transport 2. 

Do not rewind Tape Transport 2. 

3. Read one block from Tape 1 into Memory 
Location Zero. 

4. Set Toggle 24 on. 

5. Execute a JMPL Zero. 

6. CLOBDMP is typed on the Console Typewriter 
and a clobdump is executed. 


Two tapes must be assigned specific tape units; the 
System Tape on TTl and a scratch (for use as the 
intermediate dump tape) on TT2. All other tapes may 
be mounted on any available transport and, as each 
is required, the typeout TAPE XXXXXXX = occurs, 
and the computer stalls in a tight loop. At this time, 
the position of the toggle (0-15) which corresponds 
to the lOP plug number associated with TAPE XXXXXXX 
must be changed, Tlie Console Typewriter then types 
the plug number and a question mark, and the computer 
stalls again. If this is the correct plug number, the 
toggle should be returned to its original position. The 
Console Typewriter again types the plug number and 
the System will continue operation. If the plug number 
is incorrect, change the position of another toggle 
(0-15) and repeat the above procedure. 

TYPE-OUT TAPE REQUESTED 


TSYSCRO 

TSYSCR3 

TSYSCR4 

TSYSCR6 

TSYSLIB 

TSYSIN 

TSYSOUT 


System scratch (write-enabled) 
System scratch (write-enabled) 
System scratch (write-enabled) 
System scratch (write-enabled) 
System library 
System input 

System output (write-enabled) 
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ERROR 

TOGGLES 


SPECIAL 

OPERATOR 

ACTIONS 


ucner tape names, as requireo, wiix oe riocea on me 
JOB request form. 

The Error Toggles are examined every time a JMPL 1 
is executed. If an Error Toggle is set, a message is 
typed on the Console Typewriter and written on TSYS- 
OUT. Toggle 46 is examined; if it is not set, dumps 
and/or snaps are edited for printing, A search is 
then made for the next JOB instruction unless Toggle 
47 is set (refer to Special Operator Actions below). 

ERROR TOGGLE MEANING 


45 Unexpected halt 

44 Program in loop 

43 Deficient operating instruc¬ 

tions 

42 Time limit for run exceeded 

41 Tape error 

40 Machine error 

39 Job arbitrarily stopped 


Inhibit dumps/snaps toggle: Toggle 46. 

Before each JOB control card is executed and each time 
a JMPL 1 is executed. Toggle 47 (the Action Toggle) is 
examined. If it is on, SET TOGGLES is typed on the 
Console Typewriter and the computer stalls until the 
toggle is turned off. Then toggles 16 to 23 are examined 
and the appropriate action is taken by the System, 

TOGGLE ACTION 


23 Tapes specified by toggles 0-15 

are freed and nn FREE is typed 
on the Console Typewriter for 
each tape released. 

21 32KSYS is set to accept aU input 

via the Console Typewriter until 
toggle 21 is set off or until a 
CONIN IMAGE or CONIN CODE 
instruction is encountered. 

Whenever control instructions 
are entered from the Console 
Typewriter, a carriage return 



TOGGLE 


ACTION 


REMARKS 

JOB ENDINPUT 


character must end each instruc¬ 
tion line. If a typing error should 
occur, the entire instruction may 
be re-entered by pressing the 
STOP CODE Key. In response 
to this action 32KSYS issues a 
carriage return and requests a 
new type-in via the white Hght 
signal. 

Refer to Remarks under Console 
Typewriter mode. 

^0 WRAPOUT is typed on the Con¬ 

sole Typewriter and TSYSOUT 
is wrapped-up, 

^9 RERUN is typed on the Console 

Typewriter and the currf'-'t 'ob 
is rerun. 

WRAPIN is typed on the T or cole 
Typewriter and TSYSIN 
wrapped-up. 

System searches backwards for 
JOB card and types the job ID on 
the Console Typewriter. 

System searches forward for 
JOB card and types the job ID on 
the Console Typewriter. 

If toggle 16 or 17 is used, it must remain set until the 
desired job is encountered. 

When JOB ENDINPUT is typed on the Console Type¬ 
writer and the computer halts. The operator must 
select one of the above-mentioned actions (e.g. , wrap- 
up TSYSIN. wrapup TSYSOUT. etc.), by setting 
TOGGLE 47 and executing a JMPL 1. 
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APPENDIX B 


ALPHABETICAL LISTING OF CONSOLE TYPEWRITER TYPE-OUTS 


Type-Out 

Error/Normal 

Source 

Explanation 

IDMPTAC 

Error 

TAG 

Either a machine or a program 
error was detected during the 
first pass of TAG. A GLOBDMP 
should be taken. 

2DMPTAC 

Error 

TAG 

Either a machine or a program 
error was detected during the 
second pass of TAG. A GLOBDMP 
should be taken. 

32KSYS 

mmddyy 

Normal 

32KSYS 

The system was just initialized. 
The type-out indicates the sys¬ 
tem version. 

AIDE El 

Error 

AIDE 

An illegal control card was de¬ 
tected. 

AIDE E2 

Error 

AIDE 

A parameter is missing. 

AIDE E3 

Error 

AIDE 

A begin-tape error was detected; 
no sentinel was found. 

AIDE E4 

Error 

AIDE 

More than eight characters were 
specified in the sentinel para¬ 
meter. 

ANAL El 

Error 

ANALYZER 

An illegal control card was de¬ 
tected. 

ANAL E2 

Error 

ANALYZER 

The tape specified is reserved by 
the system. 

ANAL E3 

Error 

ANALYZER 

Parameters are missing. 

ANAL E4 

Error 

ANALYZER 

The specified format is not ABS 
or RPL. 

ANAL E5 

Error 

ANALYZER 

An illegal RPL section word was 
detected. 

ANAL E6 

Error 

ANALYZER 

An illegal ABS card was detected. 

ANAL E7 

Error 

ANALYZER 

A checksum error was detected. 
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Type-Out 


Error/Normal Source 


Explanation 


ANAL E8 

Error 

ANALYZER 

The end parameter was less than 
the begin parameter. 

nn ASSIGNED 
TO symb 

Normal 

32KSYS 

Logical unit nn is assigned to 
symbolic tape symb. (The com- 
puter will stall until the operator 
selects another unit). 

symb BAD 

li6 

Error 

TAC 

Information found on tape symb 
is not library data. 

nnnn BLKS 

Normal 

TAC 

nnnn blocks were produced in the 
compiled RPL program. 

CLOBDMP 

Normal 

32KSYS 

The catastrophic dump is being 
executed. 

CLOCK 

FAILURE 

Error 

32KSYS 

A clock order was not accepted. 

CMPERRS 

Error 

TAC 

FORTRAN 

One or more serious compilation 
errors were detected. 

CONTROL 

CARD 

ERROR 

Error 

PERT 

An illegal card for PERT run 
was detected. 

nnnn CARDS 

Normal 

TAC 

OPAL 

FORTRAN 

nnnn cards were generated.. 

DATA El 

Error 

DATA 

An illegal control card was de¬ 
tected. 

DATA E2 

Error 

DATA 

The tape specified is reserved by 
the system. 

DATA E3 

Error 

DATA 

An illegal format parameter was 
detected. 

DATA E4 

Error 

DATA 

The input is not image as speci- 
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Type-Out 

Error / Normal 

Source 

Explanation 

DATA E5 

Error 

DATA 

The number of word* per card wae 
not specified or is illegal. 

DATA E6 

Error 

DATA 

The number of cards per block was 
not specified or is illegal. 

DATA E7 

Error 

DATA 

The (number of words per card) x 
(cards per block) is illegal. 

DATA E8 

Error 

DATA 

More than eight characters are 
specified in a parameter. 

DATA E9 

Error 

DATA 

A parameter is not numeric. 

DIFFER¬ 

ENCES 

Normal 

AIDE 

The comparison of two magnetic 
tapes is complete and inequalities 
were detected. 

DUMPPERT 

Error 

PERT 

Either a machine or a program 
error was detected during PERT. 

A CLOBDMP should be taken. 

EALTAC 

Error 

ALTAC 

A source language error has been 
detected that would cause gener- 
atioii of an incorrect object pro- 
gram. Control was transferred 
to SYS. ICOMPER. 

ECOBOL 

Error 

COBOL 

A source language error has been 
detected that would cause gener¬ 
ation of an incorrect object pro¬ 
gram. Control was transferred 
to SYS. ICOMPER. 

ENDCOMP 

Normal 

FORTRAN 

Compilation is complete without 
serious error. 

EREPORT 

Error 

REPORT 

GENER¬ 

ATOR 

A source language error has been 
detected. Control was trans¬ 
ferred to SYS. ICOMPER. 

F4DUMP 

Error 

FORTRAN 

Machine or compiler error. 


Computer halts. Press advance 
to wrap up compilation. 
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Type-Out 

Error/Normal 

Source 

Explanation 

GENERR 

Error 

TAG 

The generator is requesting more 
parameters than were supplied. 

ID IS^ 

Normal 

TAG 

OPAL 

FORTRAN 

The identification of a compiled 
program is id. 

ID IS id 
nn C AR DS 

Normal 

WRTABS 

An ABS program of the designated 
ID, containing nn cards has been 
written on TSYSOUT. 

INSUFFI¬ 

CIENT 

MEMORY 

Error 

OPAL 

OPAL requires more memory. 

JOB id 

Normal 

32KSYS 

The system has recognized a JOB 
card, id is the first 16 characters 
of the Address and Remarks field 
of the JOB card. 

LIBEl 

to 

LIBE47 

Error 

PLUM 

For exaplanation of these PLUM 
errors see PLUM description in 
Service Routines. 

mm-dd 
hh-mm. t 

Normal 

SYS 

A JOB card or CLOCK instruction 
was executed, mm = month; 
dd = day; hh = hour; mm = minute; 
t = tenth of minute. 

symb NO 

LIB 

Error 

TAG 

Tape symb is not a library tape. 

NO LIB 

Error 

COBOL 

A COBOL library required by the 
source program is not mounted on 
the correct tape. 

NO IDEN¬ 
TITY 

Error 

FORTRAN 

First non-blank card did not con¬ 
tain program ID. Compilation 
continues in normal manner. 

OPAL 

error 

Error 

OPAL 

Machine or compiler error was 
detected. 

OPER 39 

Error 

32KSYS 

The job was arbitrarily stopped; 
the operator dumped the job. 
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Type-Out 

Error/Normal 

Source 

Explanation 

OPER 40 

Error 

32KSYS 

Machine trouble occurred and 
the operator dumped the job. 

OPER 41 

Error 

32KSYS 

Tape trouble occurred and the 
operator dumped the job. 

OPER 42 

Error 

32KSYS 

The time limit for the run was 
exceeded, the operator dumped 
job. 

OPER 43 

Error 

32KSYS 

Deficient operating instructions; 
the operator dumped the job. 

OPER 44 

Error 

32KSYS 

The program was in a loop; 
operator dumped the job. 

OPER 45 

Error 

32KSYS 

An unexpected halt occurred; the 
operator dumped the job. 

PERT III 

Normal 

PERT 

Start of PERT run. 

PROGRAM 
TAPE IS_t, 

Normal 

OPAL 

The object program tape is t. 

REINIT 

Error 

32KSYS 

The system was not read into 
memory and must be reinitialized. 

RERUN 

Normal 

32KSYS 

The current JOB is to be rerun 
by operator choice. 

RPLC El 

Error 

RPLC 

An illegal control card was 
detected. 

RPLC E2 

Error 

RPLC 

The tape specified is NEWTAPE 
or reserved by system. 

RPLC E3 

Error 

RPLC 

NEWTAPE was not specified. 

RPLC E4 

Error 

RPLC 

A sentinel block prevented the 
completion of the function. 

RPLC E5 

Error 

RPLC 

The card following the IDCHANGE 
control is not an I card. 
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Typ«-Out 

Error/Normal 

Source 

Explanation 

RPLC E6 

Error 

RPLC 

An illegal section word was de¬ 
tected. 

RPLC E7 

Error 

RPLC 

An illegal correction card was 
detected and the card was ignored. 

RPLC E8 

Error 

RPLC 

More than eight characters were 
specified in the sentinel parameter 

RPLC E9 

Error 

RPLC 

The id is missing on the addition 
or correction of an ABS deck. 

RPLC ElO 

Error 

RPLC 

A checksum error was detected. 

RPLC Ell 

Error 

RPLC 

An illegal control card was de¬ 
tected. 

RPLC E12 

Error 

RPLC 

An illegal parameter was de¬ 
tected in the ENDALL card. 

SEARCH 

NEXT 

JOB VIA 
TOGGLES 

Error 

32KSYS 

The system cannot find the next 
job. The operator should find 
the next JOB via the Search toggle 
(Refer to Special Operator 

Actions.). 

SET 

TOGGLES 

Normal 

32KSYS 

The action toggle was set by the 
operator (action is specified by 
toggles 16-23.). 

SYSEl 

Error 

32KSYS 

The program is not on the speci¬ 
fied tape. 

SYSE2 

Error 

32KSYS 

A Checksum error was detected. 

SYSE3 

Error 

32KSYS 

The program origin is in list 
area. 

SYSE4 

Error 

32KSYS 

The program origin is in common 
area. 

SYSE5 

Error 

32KSYS 

Undefined refout(s) are specified. 

SYSE6 

Error 

32KSYS 

An illegal card was detected. 
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Type-Out 

Error/Normal 

Source 

Explanation 

SYSE7 

Error 

32KSYS 

There was an overflow in the 
symbol list. 

SYSE8 

Error 

32KSYS 

An illegal section word was de¬ 
tected. 

SYSE9 

Error 

32KSYS 

An illegal tape name was specified. 

SYSEIO 

Error 

32KSYS 

The tape name was previously 
defined. 

SYSEll 

Error 

32KSYS 

An illegal address parameter 
was specified. 

SYSE12 

Error 

32KSYS 

An illegal pun was specified. 

SYSE13 

Error 

32KSYS 

Too many parameters were 
specified. 

SYSE14 

Error 

32KSYS 

There was an overflow in the 

PUN table. 

SYSE15 

Error 

32KSYS 

A job card was intercepted. 

SYSE16 

Error 

32KSYS 

An unaccountable machine or 
system error was detected. 

SYSE17 

Error 

32KSYS 

An illegal 32KSYS control instruc¬ 
tion was detected. 

SYSE18 

Error 

32KSYS 

An illegal mnemonic was specified. 

SYSE19 

Error 

32KSYS 

An illegal decimal number was 
specified. 

SYSE20 

Error 

32KSYS 

An illegal position for the binary 
point was specified. 

SYSEZl 

Error 

32KSYS 

Parameter!s) are missing. 

SYSE22 

Error 

32KSYS 

Specified symbol is not in the 
symbol list. 
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Type - Out 

Error/Normal 

Source 

Explanation 

SYSE23 

Error 

32KSYS 

Illegal from-to parameter was 

SYSE24 

Error 

32KSYS 

The parameter is too long. 

SYSE25 

Error 

32KSYS 

The common size exceeds 

memory, 

SYSE26 

Error 

32KSYS 

An illegal break character was 
spec ified. 

SYSE27 

Error 

32KSYS 

An illegal magtape parameter 
was specified. 

SYSE28 

Error 

32KSYS 

The NAME.FLAD specified is too 
long. 

SYSE29 

Error 

32KSYS 

An illegal number of words is to 
be replaced. 

SYSE30 

Error 

32KSYS 

An illegal parameter was specified. 

SYSE31 

Error 

32KSYS 

TSYSTEM, TSYSIN, and TSYSLIB 
cannot be write-enabled. 

SYSE32 

Error 

32KSYS 

An illegal prog tape was specified. 

SYSE33 

Error 

32KSYS 

An illegal octal number was 
specified. 

SYSE34 

Error 

32KSYS 

Too many blocks were specified 
to be read. 

SYSE35 

Error 

32KSYS 

The format for the internal loader 
was not specified. 

SYSE36 

Error 

32KSYS 

Reading to the sentinel will exceed 
memory. 

SYSE37 

Error 

32KSYS 

No address was specified in 
location field. 

SYSE38 

Error 

32KSYS 

An illegal format was specified. 
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Type-Out 

Error/Normal 

Source 

Explanation 

SYSE39 

Error 

32KSYS 

The new common block length 
exceeds the old. 

SYSE40 

Error 

32KSYS 

The program origin equals zero. 

SYSE41 

Error 

32KSYS 

Illegal use of TSYSIN if 32KSYS 
is in Magtape mode. 

SYSE42 

Error 

32KSYS 

An illegal START-END parameter 
was specified. 

SYSE43 

Error 

32KSYS 

The third parameter is not (MAS¬ 
TER). 

SYSE44 

Error 

32KSYS 

The master program is not defined. 

SYSE45 

Error 

32KSYS 

The segment area is empty. 

SYSE46 

Error 

32KSYS 

A symbo’ defined more than once 
was referenced. 

SYSE47 

Error 

32KSYS 

A referenced symbol was re¬ 
defined. 

SYSE48 

Error 

32KSYS 

It is illegal to locate on TSYSIN. 

SYSE49 

Error 

32KSYS 

The relative CSA exceeds PMAX. 

SYSE50 

Error 

32KSYS 

LIB must be used if SUBS or 

NOSUBS specified. 

SYSE51 

Error 

32KSYS 

An illegal library tape was 
specified. 

SYSE52 

Error 

32KSYS 

More than 7 library tapes were 
specified. 

SYSE53 

Error 

32KSYS 

Parameter(8) were specified 
more than once. 

SYSE54 

Error 

32KSYS 

A reference was made to an 
undefined common block. 

SYSE55 

Error 

32KSYS 

There was an overflow in the tape 
name table. 
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Error/Normal Source 


Exolanation 



SYSE56 

Error 

32KSYS 

Parameter n is illegal. 

SYSE57 

Error 

32KSYS 

Parameter n is missing. 

SYSE58 

Error 

32KSYS 

Illegal GSA while loading. 

TABOVER 

Error 

AETAG3X 

There was overflow in the TAG 
symbol table. Gompilation ends. 

TAGS El 

Error 

TAGSERV 

An illegal control card was de¬ 
tected. 

TAGS E2 

Error 

TAGSERV 

The tape specified is NEWTAPE 
or is a reserved System tape. 

TAGS E3 

Error 

TAGSERV 

NEWTAPE has not been specified 

TAGS E4 

Error 

TAGSERV 

A sentinel block prevented com¬ 
pletion of a function. 

TAGS E5 

Error 

TAGSERV 

An END card was found before 
the specified FLAD/sequence 
number. 


TAGS E6 

Error 

TAGSERV 

Deletion of an END card was 
attempted. 

TAGS E7 

Error 

TAGSERV 

More than 8 characters were 
specified in a sentinel parameter. 

TAGS E8 

Error 

TAGSERV 

An illegal parameter was specified 
in the ENDALL GARD. 

TAGS E9 

Error 

TAGSERV 

AN "1" card was intercepted. 

TAGS ElO 

Error 

TAGSERV 

Gard(s) ignored during search 
for "ENDPROG" card. 

TAGS Ell 

Error 

TAGSERV 

Replacement of an "END" card 
was attempted -- new card not 
"END". 

TAGS E12 

Error 

TAGSERV 

The card specified by symb + n 


has already been transferred. 
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Type-Out 

Error/Normal 

Source 

Explanation 

TAGS El3 

Error 

TACSERV 

More than eight characters were 
specified in the sequence para¬ 
meter. 

symb TAPE 
nn IN 
LOCAL 

Error 

32KSYS 

XORD 

Unit is mechanically unavailable. 
Place tape in remote and press 
advance. 

symb TAPE 
nn 

WRTNABL 

Error 

32KSYS 

XORD 

Unit should be write enabled. 
Write enable the tape and press 
advance. 

symb TAPE 

nn 

ROCKED 

Error 

32KSYS 

XORD 

XORD has made repeated un¬ 
successful attempts to fix parity 
and/or sprocket errors. Press 
advance to retry, or dump job.* 

symb TAPE 

nn 

ILL. WRT 

Error 

32KSYS 

XORD 

XORD has been told to write on a 
tape that has not been write- 
enabled, and should not be used 
as an output tape. Dump job. 

symb TAPE 

nn 

PROGERR 

Error 

32KSYS 

XORD 

XORD has received, from the 
calling program, an improper 
parameter. Dump job. 

symb TAPE 

nn 

SYSERR 

Error 

32KSYS 

XORD 

XORD has been partially 
clobbered, or hardware problem. 
Dump job. 

symb TAPE 
nn DIS¬ 
ABLED 

Error 

32KSYS 

XORD 

Unit became mechanically dis¬ 
abled while executing an order. 
Dump job. * 

symb TAPE 
nn BEG 
TAPE 

Error 

32KSYS 

XORD 

XORD has been told to process a 
block prior to the first block on 
tape. Dump job. 

symb TAPE 
nn END 
TAPE 

Error 

32KSYS 

XORD 

XORD has been told to process 
a block after the laat.block on 
tape. Dump job. 


If serious tape error occurs during compilation, see Remark 2 under TAG. 




Type-Out 

Error/Normal 

Source 

Explanation * 

symb TAPE 
nn 

SI ERROR 

Error 

32KSYS 

XORD 

• A begin block mark has been 
missed. Dump job. * 

symb TAPE 
nn 

S2 ERROR 

Error 

32KSYS 

XORD 

An end block mark has been 
missed. Dump job. * 

symb TAPE 

nn 

BAD FIX 

Error 

32KSYS 

XORD 

A serious error has occurred 
while XORD was trying to fix 
parity and/or sprocket errors. 
Dump job. 

symb TAPE 
nn 

FAULTY 

Error 

32KSYS 

XORD 

Some combination of faults has 
occurred or there is hardware 
problems. Dump job. 

TOO MANY 
PREDEC¬ 
ESSORS 

OR SUC¬ 
CESSORS 

Error 

PERT 

An error was detected in the 
input data. 

^TOTAL 
BLOCKS 

nn 

Normal 

FLID 

ID of a program and the number 
of blocks in that program. 

TOTAL 

BLOCKS 

COPIES 

nnnn 

INCLUDING 
A SENTINEL 
of xxxxxxxx 

Normal 

AIDE 

nnnn blocks were copied to 
sentinel xxxxxxxx 

WRAPIN 

Normal 

32KSYS 

The wrapup function for tape 
TSYSIN was executed. 

WRAPOUT 

No rmal 

32KSYS 

The wrapup fimction for tape 
TSYSOUT was executed. 


* If serious tape error occurs during coTrpilation, see Remekk 2 under TAG. 
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